nspi

type AndRestriction struct {
	// cRes:  Encodes the RestrictCount field of the AndRestriction and OrRestriction data
	// structures. This value MUST NOT exceed 100,000.
	RestrictionCount uint32 `idl:"name:cRes" json:"restriction_count"`
	// lpRes:  Encodes the Restricts field of the AndRestriction and OrRestriction data
	// structures.
	Restriction []*Restriction `idl:"name:lpRes;size_is:(cRes)" json:"restriction"`
}

type Binary struct {
	// cb:  The number of uninterpreted bytes represented in this structure. This value
	// MUST NOT exceed 2,097,152.
	Length uint32 `idl:"name:cb" json:"length"`
	// lpb:  The uninterpreted bytes.
	Value []byte `idl:"name:lpb;size_is:(cb)" json:"value"`
}

type BinaryArray struct {
	// cValues:  The number of Binary_r data structures represented in the BinaryArray_r
	// structure. This value MUST NOT exceed 100,000.
	ValuesCount uint32 `idl:"name:cValues" json:"values_count"`
	// lpbin:  The Binary_r data structures.
	Values []*Binary `idl:"name:lpbin;size_is:(cValues)" json:"values"`
}

type BindRequest struct {
	// dwFlags:  A DWORD value containing a set of bit flags. The server MUST ignore values
	// other than the bit flag fAnonymousLogin.
	Flags uint32 `idl:"name:dwFlags" json:"flags"`
	// pStat: A pointer to a STAT block describing a logical position in a specific address
	// book container. This parameter is used to specify both input parameters from the
	// client and return values from the NSPI server.
	Stat *Stat `idl:"name:pStat" json:"stat"`
	// pServerGuid: The value NULL or a pointer to a GUID value associated with the specific
	// NSPI server.
	ServerGUID *FlatUID `idl:"name:pServerGuid;pointer:unique" json:"server_guid"`
}

type BindResponse struct {
	// pServerGuid: The value NULL or a pointer to a GUID value associated with the specific
	// NSPI server.
	ServerGUID *FlatUID `idl:"name:pServerGuid;pointer:unique" json:"server_guid"`
	// contextHandle: An RPC context handle as specified in section 2.3.9.
	ContextHandle *Handle `idl:"name:contextHandle;pointer:ref" json:"context_handle"`
	// Return: The NspiBind return value.
	Return int32 `idl:"name:Return" json:"return"`
}

type BitMaskRestriction struct {
	// relBMR:  Encodes the BitmapRelOp field of the BitMaskRestriction data structure.
	BitMaskRestriction uint32 `idl:"name:relBMR" json:"bit_mask_restriction"`
	// ulPropTag:  Encodes the PropTag field of the BitMaskRestriction data structure.
	PropertyTag uint32 `idl:"name:ulPropTag" json:"property_tag"`
	// ulMask:  Encodes the Mask field of the BitMaskRestriction data structure.
	Mask uint32 `idl:"name:ulMask" json:"mask"`
}

type CharStringArray struct {
	// cValues:  The number of 8-bit character strings references represented in the StringArray_r
	// structure. This value MUST NOT exceed 100,000.
	ValuesCount uint32 `idl:"name:cValues" json:"values_count"`
	// lppszA:  The 8-bit character string references. The strings referred to are NULL-terminated.
	Values []string `idl:"name:lppszA;size_is:(cValues);string" json:"values"`
}

type CharStringsArray struct {
	// Count:  The number of character string structures in this aggregation. The value
	// MUST NOT exceed 100,000.
	Count uint32 `idl:"name:Count" json:"count"`
	// Strings:  The list of character type strings in this aggregation. The strings in
	// this list are NULL-terminated.
	Strings string `idl:"name:Strings;size_is:(Count);string" json:"strings"`
}

type CompareMIDsRequest struct {
	// hRpc:  An RPC context handle as specified in section 2.3.9.
	Handle *Handle `idl:"name:hRpc" json:"handle"`
	// pStat: pStat: A reference to a STAT block describing a logical position in a specific
	// address book container.
	Stat *Stat `idl:"name:pStat" json:"stat"`
	// MId1: A DWORD value containing a MId.
	MID1 uint32 `idl:"name:MId1" json:"m_id1"`
	// MId2: A DWORD value containing a MId.
	MID2 uint32 `idl:"name:MId2" json:"m_id2"`
}

type CompareMIDsResponse struct {
	// plResult: A DWORD value. On return, it contains the result of the comparison.
	Result int32 `idl:"name:plResult" json:"result"`
	// Return: The NspiCompareMIds return value.
	Return int32 `idl:"name:Return" json:"return"`
}

type ComparePropertiesRestriction struct {
	// relop:  Encodes the RelOp field of the ComparePropsRestriction data structure.
	Op uint32 `idl:"name:relop" json:"op"`
	// ulPropTag1:  Encodes the PropTag1 field of the ComparePropsRestriction data structure.
	PropertyTag1 uint32 `idl:"name:ulPropTag1" json:"property_tag1"`
	// ulPropTag2:  Encodes the PropTag2 field of the ComparePropsRestriction data structure.
	PropertyTag2 uint32 `idl:"name:ulPropTag2" json:"property_tag2"`
}

type ContentRestriction struct {
	FuzzyLevel  uint32         `idl:"name:ulFuzzyLevel" json:"fuzzy_level"`
	PropertyTag uint32         `idl:"name:ulPropTag" json:"property_tag"`
	Property    *PropertyValue `idl:"name:lpProp" json:"property"`
}

type DNToMIDRequest struct {
	// hRpc:  An RPC context handle as specified in section 2.3.9.
	Handle *Handle `idl:"name:hRpc" json:"handle"`
	// pNames: A StringsArray_r value. It holds a list of strings containing DNs, according
	// to [MS-OXOABK].
	Names *CharStringsArray `idl:"name:pNames" json:"names"`
}

type DNToMIDResponse struct {
	// ppOutMIds: A PropertyTagArray_r value. On return, it holds a list of MIds.
	OutMIDs *PropertyTagArray `idl:"name:ppOutMIds" json:"out_m_ids"`
	// Return: The NspiDNToMId return value.
	Return int32 `idl:"name:Return" json:"return"`
}

type DateTimeArray struct {
	// cValues:  The number of FILETIME data structures represented in the DateTimeArray_r
	// structure. This value MUST NOT exceed 100,000.
	ValuesCount uint32 `idl:"name:cValues" json:"values_count"`
	// lpft:  The FILETIME data structures.
	Values []*dtyp.Filetime `idl:"name:lpft;size_is:(cValues)" json:"values"`
}

type ExistRestriction struct {

	// ulPropTag:  Encodes the PropTag field of the ExistRestriction data structure.
	PropertyTag uint32 `idl:"name:ulPropTag" json:"property_tag"`
	// contains filtered or unexported fields
}

type FlatUID struct {
	// ab:  Encodes the ordered bytes of the FlatUID data structure.
	Value []byte `idl:"name:ab" json:"value"`
}

type FlatUIDArray struct {
	// cValues:  The number of FlatUID_r structures represented in the FlatUIDArray_r structure.
	// This value MUST NOT exceed 100,000.
	ValuesCount uint32 `idl:"name:cValues" json:"values_count"`
	// lpguid:   The FlatUID_r data structures.
	GUID []*FlatUID `idl:"name:lpguid;size_is:(cValues)" json:"guid"`
}

type GetIDsFromNamesRequest struct {
	// hRpc: An RPC context handle as specified in section 2.3.9.
	Handle *Handle `idl:"name:hRpc" json:"handle"`
	// dwFlags: A DWORD value. All clients MUST set this value to either 0 or the flag NspiVerifyNames.
	Flags uint32 `idl:"name:dwFlags" json:"flags"`
	// cPropNames: A DWORD value containing the number property names supplied by the client.
	// The value is limited to 100,000.
	PropertyNamesCount uint32 `idl:"name:cPropNames" json:"property_names_count"`
	// pNames: A reference to a PropertyName_r value. Contains a list of property names
	// supplied by the client.
	Names []*PropertyName `idl:"name:pNames;size_is:(cPropNames)" json:"names"`
}

type GetIDsFromNamesResponse struct {
	// ppPropTags: A reference to a PropertyTagArray_r value. On successful return to the
	// client, contains a list of proptags.
	PropertyTags *PropertyTagArray `idl:"name:ppPropTags" json:"property_tags"`
	// Return: The NspiGetIDsFromNames return value.
	Return int32 `idl:"name:Return" json:"return"`
}

type GetMatchesRequest struct {
	// hRpc: An RPC context handle as specified in section 2.3.9.
	Handle *Handle `idl:"name:hRpc" json:"handle"`
	// pStat: A reference to a STAT block describing a logical position in a specific address
	// book container.
	Stat *Stat `idl:"name:pStat" json:"stat"`
	// Filter: The value NULL or a Restriction_r value. Holds a logical restriction to apply
	// to the rows in the address book container specified in the pStat parameter.
	Filter *Restriction `idl:"name:Filter;pointer:unique" json:"filter"`
	// lpPropName: The value NULL or a PropertyName_r value. Holds the property to be opened
	// as a restricted address book container.
	PropertyName *PropertyName `idl:"name:lpPropName;pointer:unique" json:"property_name"`
	// ulRequested: A DWORD value. Contains the maximum number of rows to return in a restricted
	// address book container.
	Requested uint32 `idl:"name:ulRequested" json:"requested"`
	// pPropTags:  The value NULL or a reference to a PropertyTagArray_r value. Contains
	// list of the proptags of the columns that client wants to be returned for each row
	// returned.
	PropertyTags *PropertyTagArray `idl:"name:pPropTags;pointer:unique" json:"property_tags"`
}

type GetMatchesResponse struct {
	// pStat: A reference to a STAT block describing a logical position in a specific address
	// book container.
	Stat *Stat `idl:"name:pStat" json:"stat"`
	// ppOutMIds:  A PropertyTagArray_r value. On return, it holds a list of MId that comprise
	// a restricted address book container.
	OutMIDs *PropertyTagArray `idl:"name:ppOutMIds" json:"out_m_ids"`
	// ppRows:  A reference to a PropertyRowSet_r value. Contains the address book container
	// rows the server returns in response to the request.
	Rows *PropertyRowSet `idl:"name:ppRows" json:"rows"`
	// Return: The NspiGetMatches return value.
	Return int32 `idl:"name:Return" json:"return"`
}

type GetNamesFromIDsRequest struct {
	// hRpc: An RPC context handle as specified in section 2.3.9.
	Handle *Handle `idl:"name:hRpc" json:"handle"`
	// lpguid: The value NULL or a FlatUID_r value. Specifies the property set about which
	// the client is requesting information.
	GUID *FlatUID `idl:"name:lpguid;pointer:unique" json:"guid"`
	// pPropTags: The value NULL or a PropertyTagArray_r value. Specifies the specific Property
	// IDs about which the client is requesting information.
	PropertyTags *PropertyTagArray `idl:"name:pPropTags;pointer:unique" json:"property_tags"`
}

type GetNamesFromIDsResponse struct {
	// ppReturnedPropTags: Contains an SPropTagArray. On return, it contains a list of all
	// the proptags in the property set specified in the input parameter lpguid. If lpguid
	// is NULL, this value MUST be NULL.
	ReturnedPropertyTags *PropertyTagArray `idl:"name:ppReturnedPropTags" json:"returned_property_tags"`
	// ppNames:  A PropertyNameSet_r value. On return, it contains a list of property names
	// satisfying the client's request.
	Names *PropertyNameSet `idl:"name:ppNames" json:"names"`
	// Return: The NspiGetNamesFromIDs return value.
	Return int32 `idl:"name:Return" json:"return"`
}

type GetPropertiesRequest struct {
	// hRpc: An RPC context handle as specified in section 2.3.9.
	Handle *Handle `idl:"name:hRpc" json:"handle"`
	// dwFlags: A DWORD value, containing a set of bit flags. The server MUST ignore values
	// other than the bit flags fEphID and fSkipObjects.
	Flags uint32 `idl:"name:dwFlags" json:"flags"`
	// pStat: A pointer to a STAT block describing a logical position in a specific address
	// book container. This parameter is used to both specify input parameters from the
	// client and return values from the NSPI server.
	Stat *Stat `idl:"name:pStat" json:"stat"`
	// pPropTags: The value NULL or a reference to a PropertyTagArray_r value. Contains
	// list of the proptags of the properties that the client wants to be returned.
	PropertyTags *PropertyTagArray `idl:"name:pPropTags;pointer:unique" json:"property_tags"`
}

type GetPropertiesResponse struct {
	// ppRows: A reference to a PropertyRow_r value. Contains the address book container
	// row the server returns in response to the request.
	Rows *PropertyRow `idl:"name:ppRows" json:"rows"`
	// Return: The NspiGetProps return value.
	Return int32 `idl:"name:Return" json:"return"`
}

type GetPropertyListRequest struct {
	// hRpc: An RPC context handle as specified in section 2.3.9.
	Handle *Handle `idl:"name:hRpc" json:"handle"`
	// dwFlags: A DWORD value, containing a set of bit flags. The server MUST ignore values
	// other than the bit flag fSkipObjects.
	Flags uint32 `idl:"name:dwFlags" json:"flags"`
	// dwMId: A DWORD value, containing a MId.
	MID uint32 `idl:"name:dwMId" json:"m_id"`
	// CodePage: The codepage in which the client wishes the server to express string values
	// properties.
	CodePage uint32 `idl:"name:CodePage" json:"code_page"`
}

type GetPropertyListResponse struct {
	// ppPropTags: A PropertyTagArray_r value. On return, it holds a list of properties.
	PropertyTags *PropertyTagArray `idl:"name:ppPropTags" json:"property_tags"`
	// Return: The NspiGetPropList return value.
	Return int32 `idl:"name:Return" json:"return"`
}

type GetSpecialTableRequest struct {
	// hRpc: An RPC context handle as specified in section 2.3.9.
	Handle *Handle `idl:"name:hRpc" json:"handle"`
	// dwFlags:  A DWORD value containing a set of bit flags. The server MUST ignore values
	// other than the bit flags NspiAddressCreationTemplates and NspiUnicodeStrings.
	Flags uint32 `idl:"name:dwFlags" json:"flags"`
	// pStat: A pointer to a STAT block describing a logical position in a specific address
	// book container. This parameter is used to both specify input parameters from the
	// client and return values from the NSPI server.
	Stat *Stat `idl:"name:pStat" json:"stat"`
	// lpVersion: A reference to a DWORD. On input, holds the value of the version number
	// of the address book hierarchy table that the client has.
	Version uint32 `idl:"name:lpVersion" json:"version"`
}

type GetSpecialTableResponse struct {
	// lpVersion: A reference to a DWORD. On input, holds the value of the version number
	// of the address book hierarchy table that the client has.
	Version uint32 `idl:"name:lpVersion" json:"version"`
	// ppRows:  An PropertyRowSet_r. On return, holds the rows for the table that the client
	// is requesting.
	Rows *PropertyRowSet `idl:"name:ppRows" json:"rows"`
	// Return: The NspiGetSpecialTable return value.
	Return int32 `idl:"name:Return" json:"return"`
}

type GetTemplateInfoRequest struct {
	// hRpc: An RPC context handle as specified in section 2.3.9.
	Handle *Handle `idl:"name:hRpc" json:"handle"`
	// dwFlags: A DWORD value containing a set of bit flags. The server MUST ignore values
	// other than the bit flags TI_HELPFILE_NAME, TI_HELPFILE_CONTENTS, TI_SCRIPT, TI_TEMPLATE,
	// and TI_EMT.
	Flags uint32 `idl:"name:dwFlags" json:"flags"`
	// ulType: A DWORD value. Specifies the display type of the template for which information
	// is requested.
	Type uint32 `idl:"name:ulType" json:"type"`
	// pDN: The value NULL or the DN of the template requested. The value is NULL-terminated.
	DN string `idl:"name:pDN;string;pointer:unique" json:"dn"`
	// dwCodePage: A DWORD value. Specifies the codepage of the template for which information
	// is requested.
	CodePage uint32 `idl:"name:dwCodePage" json:"code_page"`
	// dwLocaleID: A DWORD value. Specifies the LCID of the template for which information
	// is requested.
	LocaleID uint32 `idl:"name:dwLocaleID" json:"locale_id"`
}

type GetTemplateInfoResponse struct {
	// ppData: A reference to a PropertyRow_r value. On return, it contains the information
	// requested.
	Data *PropertyRow `idl:"name:ppData" json:"data"`
	// Return: The NspiGetTemplateInfo return value.
	Return int32 `idl:"name:Return" json:"return"`
}

type Handle dcetypes.ContextHandle

type LongArray struct {
	// cValues:  The number of 32-bit integers represented in this structure. This value
	// MUST NOT exceed 100,000.
	ValuesCount uint32 `idl:"name:cValues" json:"values_count"`
	// lpl:  The 32-bit integer values.
	Values []int32 `idl:"name:lpl;size_is:(cValues)" json:"values"`
}

type ModifyLinkAttributeRequest struct {
	// hRpc: An RPC context handle as specified in section 2.3.9.
	Handle *Handle `idl:"name:hRpc" json:"handle"`
	// dwFlags: A DWORD value containing a set of bit flags. The server MUST ignore values
	// other than the bit flag fDelete.
	Flags uint32 `idl:"name:dwFlags" json:"flags"`
	// ulPropTag: A DWORD value. Contains the proptag of the property that the client wishes
	// to modify.
	PropertyTag uint32 `idl:"name:ulPropTag" json:"property_tag"`
	// dwMId:  A DWORD value containing the MId of the address book row that the client
	// wishes to modify.
	MID uint32 `idl:"name:dwMId" json:"m_id"`
	// lpEntryIds: A BinaryArray value. Contains a list of Entry IDs to be used to modify
	// the requested property on the requested address book row. These Entry IDs can be
	// either Ephemeral Entry IDs or Permanent Entry IDs or both.
	EntryIDs *BinaryArray `idl:"name:lpEntryIds" json:"entry_ids"`
}

type ModifyLinkAttributeResponse struct {
	// Return: The NspiModLinkAtt return value.
	Return int32 `idl:"name:Return" json:"return"`
}

type ModifyPropertiesRequest struct {
	// hRpc:  An RPC context handle as specified in section 2.3.9.
	Handle *Handle `idl:"name:hRpc" json:"handle"`
	// pStat:  A reference to a STAT block describing a logical position in a specific
	// address book container.
	Stat *Stat `idl:"name:pStat" json:"stat"`
	// pPropTags: The value NULL or a reference to a PropertyTagArray_r. Contains list of
	// the proptags of the columns that client requests all values to be removed from.
	PropertyTags *PropertyTagArray `idl:"name:pPropTags;pointer:unique" json:"property_tags"`
	// pRow: A PropertyRow_r value. Contains an address book row.
	Row *PropertyRow `idl:"name:pRow" json:"row"`
}

type ModifyPropertiesResponse struct {
	// Return: The NspiModProps return value.
	Return int32 `idl:"name:Return" json:"return"`
}

type NotRestriction struct {
	// lpRes:  Encodes the Restriction field of the NotRestriction data structure.
	Restriction *Restriction `idl:"name:lpRes" json:"restriction"`
}

type NspiClient interface {

	// The NspiBind method initiates a session between a client and the NSPI server.
	//
	// Return Values: The server returns a long value specifying the return status of the
	// method.
	//
	// # Exceptions Thrown
	//
	// No exceptions are thrown beyond those thrown by the underlying RPC protocol, as specified
	// in [MS-RPCE].
	Bind(context.Context, *BindRequest, ...dcerpc.CallOption) (*BindResponse, error)

	// The NspiUnbind method destroys the context handle. No other action is taken.
	//
	// Return Values: The server returns a DWORD value specifying the return status of the
	// method.
	//
	// # Exceptions Thrown
	//
	// No exceptions are thrown beyond those thrown by the underlying RPC protocol, as specified
	// in [MS-RPCE].
	Unbind(context.Context, *UnbindRequest, ...dcerpc.CallOption) (*UnbindResponse, error)

	// The NspiUpdateStat method updates the STAT block representing position in a table
	// to reflect positioning changes requested by the client.
	//
	// Return Values: The server returns a long value specifying the return status of the
	// method.
	//
	// # Exceptions Thrown
	//
	// No exceptions are thrown beyond those thrown by the underlying RPC protocol, as specified
	// in [MS-RPCE].
	UpdateStat(context.Context, *UpdateStatRequest, ...dcerpc.CallOption) (*UpdateStatResponse, error)

	// The NspiQueryRows method returns to the client a number of rows from a specified
	// table. The server MUST return no more rows than the number specified in the input
	// parameter Count. Although the protocol places no further boundary or requirements
	// on the minimum number of rows the server returns, implementations SHOULD return as
	// many rows as possible subject to this maximum limit to improve usability of the NSPI
	// server for clients.
	//
	// Return Values:  The server returns a long value specifying the return status of
	// the method.
	//
	// # Exceptions Thrown
	//
	// No exceptions are thrown beyond those thrown by the underlying RPC protocol, as specified
	// in [MS-RPCE].
	QueryRows(context.Context, *QueryRowsRequest, ...dcerpc.CallOption) (*QueryRowsResponse, error)

	// The NspiSeekEntries method searches for and sets the logical position in a specific
	// table to the first entry greater than or equal to a specified value. Optionally,
	// it might also return information about rows in the table.
	//
	// Return Values: The server returns a long value specifying the return status of the
	// method.
	//
	// # Exceptions Thrown
	//
	// No exceptions are thrown beyond those thrown by the underlying RPC protocol, as specified
	// in [MS-RPCE].
	SeekEntries(context.Context, *SeekEntriesRequest, ...dcerpc.CallOption) (*SeekEntriesResponse, error)

	// The NspiGetMatches method returns an Explicit Table. The rows in the table are chosen
	// based on a two possible criteria: a restriction applied to an address book container
	// or the values of a property on a single object that hold references to other objects.
	//
	// Return Values: The server returns a long value specifying the return status of the
	// method.
	//
	// # Exceptions Thrown
	//
	// No exceptions are thrown beyond those thrown by the underlying RPC protocol, as specified
	// in [MS-RPCE].
	GetMatches(context.Context, *GetMatchesRequest, ...dcerpc.CallOption) (*GetMatchesResponse, error)

	// The NspiResortRestriction method applies a sort order to the objects in a restricted
	// address book container.
	//
	// Return Values: The server returns a long value specifying the return status of the
	// method.
	//
	// # Exceptions Thrown
	//
	// No exceptions are thrown beyond those thrown by the underlying RPC protocol, as specified
	// in [MS-RPCE].
	ResortRestriction(context.Context, *ResortRestrictionRequest, ...dcerpc.CallOption) (*ResortRestrictionResponse, error)

	// The NspiDNToMId method maps a set of DN to a set of MId.
	//
	// Return Values: The server returns a long value specifying the return status of the
	// method.
	//
	// # Exceptions Thrown
	//
	// No exceptions are thrown beyond those thrown by the underlying RPC protocol, as specified
	// in [MS-RPCE].
	DNToMID(context.Context, *DNToMIDRequest, ...dcerpc.CallOption) (*DNToMIDResponse, error)

	// The NspiGetPropList method returns a list of all the properties that have values
	// on a specified object.
	//
	// Return Values: The server returns a long value specifying the return status of the
	// method.
	//
	// # Exceptions Thrown
	//
	// No exceptions are thrown beyond those thrown by the underlying RPC protocol, as specified
	// in [MS-RPCE].
	GetPropertyList(context.Context, *GetPropertyListRequest, ...dcerpc.CallOption) (*GetPropertyListResponse, error)

	// The NspiGetProps method returns an address book row containing a set of the properties
	// and values that exist on an object.
	//
	// Return Values: The server returns a long value specifying the return status of the
	// method.
	//
	// # Exceptions Thrown
	//
	// No exceptions are thrown beyond those thrown by the underlying RPC protocol, as specified
	// in [MS-RPCE].
	GetProperties(context.Context, *GetPropertiesRequest, ...dcerpc.CallOption) (*GetPropertiesResponse, error)

	// The NspiCompareMIds method compares the position in an address book container of
	// two objects identified by MId and returns the value of the comparison.
	//
	// Return Values: The server returns a long value specifying the return status of the
	// method.
	//
	// # Exceptions Thrown
	//
	// No exceptions are thrown beyond those thrown by the underlying RPC protocol, as specified
	// in [MS-RPCE].
	CompareMIDs(context.Context, *CompareMIDsRequest, ...dcerpc.CallOption) (*CompareMIDsResponse, error)

	// The NspiModProps method is used to modify the properties of an object in the address
	// book.
	//
	// Return Values: The server returns a long value specifying the return status of the
	// method.
	//
	// # Exceptions Thrown
	//
	// No exceptions are thrown beyond those thrown by the underlying RPC protocol, as specified
	// in [MS-RPCE].
	ModifyProperties(context.Context, *ModifyPropertiesRequest, ...dcerpc.CallOption) (*ModifyPropertiesResponse, error)

	// The NspiGetSpecialTable method returns the rows of a special table to the client.
	// The special table can be an Address Book Hierarchy Table or an Address Creation Table.
	//
	// Return Values: The server returns a long value specifying the return status of the
	// method.
	//
	// # Exceptions Thrown
	//
	// No exceptions are thrown beyond those thrown by the underlying RPC protocol, as specified
	// in [MS-RPCE].
	GetSpecialTable(context.Context, *GetSpecialTableRequest, ...dcerpc.CallOption) (*GetSpecialTableResponse, error)

	// The NspiGetTemplateInfo method returns information about template objects in the
	// address book.
	//
	// Return Values: The server returns a long value specifying the return status of the
	// method.
	//
	// # Exceptions Thrown
	//
	// No exceptions are thrown beyond those thrown by the underlying RPC protocol, as specified
	// in [MS-RPCE].
	GetTemplateInfo(context.Context, *GetTemplateInfoRequest, ...dcerpc.CallOption) (*GetTemplateInfoResponse, error)

	// The NspiModLinkAtt method modifies the values of a specific property of a specific
	// row in the address book.
	//
	// Return Values: The server returns a long value specifying the return status of the
	// method.
	//
	// # Exceptions Thrown
	//
	// No exceptions are thrown beyond those thrown by the underlying RPC protocol, as specified
	// in [MS-RPCE].
	ModifyLinkAttribute(context.Context, *ModifyLinkAttributeRequest, ...dcerpc.CallOption) (*ModifyLinkAttributeResponse, error)

	// The NspiQueryColumns method returns a list of all the properties the NSPI server
	// is aware of. It returns this list as an array of proptags.
	//
	// Return Values: The server returns a long value specifying the return status of the
	// method.
	//
	// # Exceptions Thrown
	//
	// No exceptions are thrown beyond those thrown by the underlying RPC protocol, as specified
	// in [MS-RPCE].
	QueryColumns(context.Context, *QueryColumnsRequest, ...dcerpc.CallOption) (*QueryColumnsResponse, error)

	// The NspiGetNamesFromIDs method returns a list of property names for a set of proptags.
	//
	// Return Values: The server returns a long value specifying the return status of the
	// method.
	//
	// # Exceptions Thrown
	//
	// No exceptions are thrown beyond those thrown by the underlying RPC protocol, as specified
	// in [MS-RPCE].
	GetNamesFromIDs(context.Context, *GetNamesFromIDsRequest, ...dcerpc.CallOption) (*GetNamesFromIDsResponse, error)

	// The NspiGetIDsFromNames method returns a list of proptags for a set of property names.
	//
	// Return Values: The server returns a long value specifying the return status of the
	// method.
	//
	// # Exceptions Thrown
	//
	// No exceptions are thrown beyond those thrown by the underlying RPC protocol, as specified
	// in [MS-RPCE].
	GetIDsFromNames(context.Context, *GetIDsFromNamesRequest, ...dcerpc.CallOption) (*GetIDsFromNamesResponse, error)

	// The NspiResolveNames method takes a set of string values in an 8-bit character set
	// and performs ANR (as specified in 3.1.1.6) on those strings. The server reports the
	// MId that are the result of the ANR process. Certain property values are returned
	// for any valid MIds identified by the ANR process.
	//
	// Return Values: The server returns a long value specifying the return status of the
	// method.
	//
	// # Exceptions Thrown
	//
	// No exceptions are thrown beyond those thrown by the underlying RPC protocol, as specified
	// in [MS-RPCE].
	ResolveNames(context.Context, *ResolveNamesRequest, ...dcerpc.CallOption) (*ResolveNamesResponse, error)

	// The NspiResolveNamesW method takes a set of string values in the Unicode character
	// set and performs ANR (as specified in 3.1.1.6) on those strings. The server reports
	// the MId that are the result of the ANR process. Certain property values are returned
	// for any valid MIds identified by the ANR process.
	//
	// Return Values: The server returns a long value specifying the return status of the
	// method.
	//
	// # Exceptions Thrown
	//
	// No exceptions are thrown beyond those thrown by the underlying RPC protocol, as specified
	// in [MS-RPCE].
	ResolveNamesW(context.Context, *ResolveNamesWRequest, ...dcerpc.CallOption) (*ResolveNamesWResponse, error)

	// AlterContext alters the client context.
	AlterContext(context.Context, ...dcerpc.Option) error
}

type NspiServer interface {

	// The NspiBind method initiates a session between a client and the NSPI server.
	//
	// Return Values: The server returns a long value specifying the return status of the
	// method.
	//
	// # Exceptions Thrown
	//
	// No exceptions are thrown beyond those thrown by the underlying RPC protocol, as specified
	// in [MS-RPCE].
	Bind(context.Context, *BindRequest) (*BindResponse, error)

	// The NspiUnbind method destroys the context handle. No other action is taken.
	//
	// Return Values: The server returns a DWORD value specifying the return status of the
	// method.
	//
	// # Exceptions Thrown
	//
	// No exceptions are thrown beyond those thrown by the underlying RPC protocol, as specified
	// in [MS-RPCE].
	Unbind(context.Context, *UnbindRequest) (*UnbindResponse, error)

	// The NspiUpdateStat method updates the STAT block representing position in a table
	// to reflect positioning changes requested by the client.
	//
	// Return Values: The server returns a long value specifying the return status of the
	// method.
	//
	// # Exceptions Thrown
	//
	// No exceptions are thrown beyond those thrown by the underlying RPC protocol, as specified
	// in [MS-RPCE].
	UpdateStat(context.Context, *UpdateStatRequest) (*UpdateStatResponse, error)

	// The NspiQueryRows method returns to the client a number of rows from a specified
	// table. The server MUST return no more rows than the number specified in the input
	// parameter Count. Although the protocol places no further boundary or requirements
	// on the minimum number of rows the server returns, implementations SHOULD return as
	// many rows as possible subject to this maximum limit to improve usability of the NSPI
	// server for clients.
	//
	// Return Values:  The server returns a long value specifying the return status of
	// the method.
	//
	// # Exceptions Thrown
	//
	// No exceptions are thrown beyond those thrown by the underlying RPC protocol, as specified
	// in [MS-RPCE].
	QueryRows(context.Context, *QueryRowsRequest) (*QueryRowsResponse, error)

	// The NspiSeekEntries method searches for and sets the logical position in a specific
	// table to the first entry greater than or equal to a specified value. Optionally,
	// it might also return information about rows in the table.
	//
	// Return Values: The server returns a long value specifying the return status of the
	// method.
	//
	// # Exceptions Thrown
	//
	// No exceptions are thrown beyond those thrown by the underlying RPC protocol, as specified
	// in [MS-RPCE].
	SeekEntries(context.Context, *SeekEntriesRequest) (*SeekEntriesResponse, error)

	// The NspiGetMatches method returns an Explicit Table. The rows in the table are chosen
	// based on a two possible criteria: a restriction applied to an address book container
	// or the values of a property on a single object that hold references to other objects.
	//
	// Return Values: The server returns a long value specifying the return status of the
	// method.
	//
	// # Exceptions Thrown
	//
	// No exceptions are thrown beyond those thrown by the underlying RPC protocol, as specified
	// in [MS-RPCE].
	GetMatches(context.Context, *GetMatchesRequest) (*GetMatchesResponse, error)

	// The NspiResortRestriction method applies a sort order to the objects in a restricted
	// address book container.
	//
	// Return Values: The server returns a long value specifying the return status of the
	// method.
	//
	// # Exceptions Thrown
	//
	// No exceptions are thrown beyond those thrown by the underlying RPC protocol, as specified
	// in [MS-RPCE].
	ResortRestriction(context.Context, *ResortRestrictionRequest) (*ResortRestrictionResponse, error)

	// The NspiDNToMId method maps a set of DN to a set of MId.
	//
	// Return Values: The server returns a long value specifying the return status of the
	// method.
	//
	// # Exceptions Thrown
	//
	// No exceptions are thrown beyond those thrown by the underlying RPC protocol, as specified
	// in [MS-RPCE].
	DNToMID(context.Context, *DNToMIDRequest) (*DNToMIDResponse, error)

	// The NspiGetPropList method returns a list of all the properties that have values
	// on a specified object.
	//
	// Return Values: The server returns a long value specifying the return status of the
	// method.
	//
	// # Exceptions Thrown
	//
	// No exceptions are thrown beyond those thrown by the underlying RPC protocol, as specified
	// in [MS-RPCE].
	GetPropertyList(context.Context, *GetPropertyListRequest) (*GetPropertyListResponse, error)

	// The NspiGetProps method returns an address book row containing a set of the properties
	// and values that exist on an object.
	//
	// Return Values: The server returns a long value specifying the return status of the
	// method.
	//
	// # Exceptions Thrown
	//
	// No exceptions are thrown beyond those thrown by the underlying RPC protocol, as specified
	// in [MS-RPCE].
	GetProperties(context.Context, *GetPropertiesRequest) (*GetPropertiesResponse, error)

	// The NspiCompareMIds method compares the position in an address book container of
	// two objects identified by MId and returns the value of the comparison.
	//
	// Return Values: The server returns a long value specifying the return status of the
	// method.
	//
	// # Exceptions Thrown
	//
	// No exceptions are thrown beyond those thrown by the underlying RPC protocol, as specified
	// in [MS-RPCE].
	CompareMIDs(context.Context, *CompareMIDsRequest) (*CompareMIDsResponse, error)

	// The NspiModProps method is used to modify the properties of an object in the address
	// book.
	//
	// Return Values: The server returns a long value specifying the return status of the
	// method.
	//
	// # Exceptions Thrown
	//
	// No exceptions are thrown beyond those thrown by the underlying RPC protocol, as specified
	// in [MS-RPCE].
	ModifyProperties(context.Context, *ModifyPropertiesRequest) (*ModifyPropertiesResponse, error)

	// The NspiGetSpecialTable method returns the rows of a special table to the client.
	// The special table can be an Address Book Hierarchy Table or an Address Creation Table.
	//
	// Return Values: The server returns a long value specifying the return status of the
	// method.
	//
	// # Exceptions Thrown
	//
	// No exceptions are thrown beyond those thrown by the underlying RPC protocol, as specified
	// in [MS-RPCE].
	GetSpecialTable(context.Context, *GetSpecialTableRequest) (*GetSpecialTableResponse, error)

	// The NspiGetTemplateInfo method returns information about template objects in the
	// address book.
	//
	// Return Values: The server returns a long value specifying the return status of the
	// method.
	//
	// # Exceptions Thrown
	//
	// No exceptions are thrown beyond those thrown by the underlying RPC protocol, as specified
	// in [MS-RPCE].
	GetTemplateInfo(context.Context, *GetTemplateInfoRequest) (*GetTemplateInfoResponse, error)

	// The NspiModLinkAtt method modifies the values of a specific property of a specific
	// row in the address book.
	//
	// Return Values: The server returns a long value specifying the return status of the
	// method.
	//
	// # Exceptions Thrown
	//
	// No exceptions are thrown beyond those thrown by the underlying RPC protocol, as specified
	// in [MS-RPCE].
	ModifyLinkAttribute(context.Context, *ModifyLinkAttributeRequest) (*ModifyLinkAttributeResponse, error)

	// The NspiQueryColumns method returns a list of all the properties the NSPI server
	// is aware of. It returns this list as an array of proptags.
	//
	// Return Values: The server returns a long value specifying the return status of the
	// method.
	//
	// # Exceptions Thrown
	//
	// No exceptions are thrown beyond those thrown by the underlying RPC protocol, as specified
	// in [MS-RPCE].
	QueryColumns(context.Context, *QueryColumnsRequest) (*QueryColumnsResponse, error)

	// The NspiGetNamesFromIDs method returns a list of property names for a set of proptags.
	//
	// Return Values: The server returns a long value specifying the return status of the
	// method.
	//
	// # Exceptions Thrown
	//
	// No exceptions are thrown beyond those thrown by the underlying RPC protocol, as specified
	// in [MS-RPCE].
	GetNamesFromIDs(context.Context, *GetNamesFromIDsRequest) (*GetNamesFromIDsResponse, error)

	// The NspiGetIDsFromNames method returns a list of proptags for a set of property names.
	//
	// Return Values: The server returns a long value specifying the return status of the
	// method.
	//
	// # Exceptions Thrown
	//
	// No exceptions are thrown beyond those thrown by the underlying RPC protocol, as specified
	// in [MS-RPCE].
	GetIDsFromNames(context.Context, *GetIDsFromNamesRequest) (*GetIDsFromNamesResponse, error)

	// The NspiResolveNames method takes a set of string values in an 8-bit character set
	// and performs ANR (as specified in 3.1.1.6) on those strings. The server reports the
	// MId that are the result of the ANR process. Certain property values are returned
	// for any valid MIds identified by the ANR process.
	//
	// Return Values: The server returns a long value specifying the return status of the
	// method.
	//
	// # Exceptions Thrown
	//
	// No exceptions are thrown beyond those thrown by the underlying RPC protocol, as specified
	// in [MS-RPCE].
	ResolveNames(context.Context, *ResolveNamesRequest) (*ResolveNamesResponse, error)

	// The NspiResolveNamesW method takes a set of string values in the Unicode character
	// set and performs ANR (as specified in 3.1.1.6) on those strings. The server reports
	// the MId that are the result of the ANR process. Certain property values are returned
	// for any valid MIds identified by the ANR process.
	//
	// Return Values: The server returns a long value specifying the return status of the
	// method.
	//
	// # Exceptions Thrown
	//
	// No exceptions are thrown beyond those thrown by the underlying RPC protocol, as specified
	// in [MS-RPCE].
	ResolveNamesW(context.Context, *ResolveNamesWRequest) (*ResolveNamesWResponse, error)
}

type OrRestriction struct {
	RestrictionCount uint32         `idl:"name:cRes" json:"restriction_count"`
	Restriction      []*Restriction `idl:"name:lpRes;size_is:(cRes)" json:"restriction"`
}

type PropertyName struct {
	// lpguid:  Encodes the GUID field of the PropertyName data structure. This field is
	// encoded as a FlatUID_r data structure.
	GUID *FlatUID `idl:"name:lpguid" json:"guid"`

	// lID:  Encodes the lID field of the PropertyName data structure. In addition to the
	// definition of the LID field, this field is always present in the PropertyName_r data
	// structure; it is not optional.
	ID int32 `idl:"name:lID" json:"id"`
	// contains filtered or unexported fields
}

type PropertyNameSet struct {
	// cNames:  The number of PropertyName_r structures in this aggregation. The value MUST
	// NOT exceed 100,000.
	NamesCount uint32 `idl:"name:cNames" json:"names_count"`
	// aNames:  The list of PropertyName_r structures in this aggregation.
	Names []*PropertyName `idl:"name:aNames;size_is:(cNames)" json:"names"`
}

type PropertyRestriction struct {
	// relop:   Encodes the RelOp field of the PropertyRestriction data structure.
	Op uint32 `idl:"name:relop" json:"op"`
	// ulPropTag:  Encodes the PropTag field of the PropertyRestriction data structure.
	PropertyTag uint32 `idl:"name:ulPropTag" json:"property_tag"`
	// lpProp:  Encodes the TaggedValue field of the PropertyRestriction data structure.
	Property *PropertyValue `idl:"name:lpProp" json:"property"`
}

type PropertyRow struct {

	// cValues:  The number of PropertyValue_r structures represented in the PropertyRow_r
	// structure. This value MUST NOT exceed 100,000.
	ValuesCount uint32 `idl:"name:cValues" json:"values_count"`
	// lpProps:  Encodes the ValueArray field of the StandardPropertyRow data structure.
	Properties []*PropertyValue `idl:"name:lpProps;size_is:(cValues)" json:"properties"`
	// contains filtered or unexported fields
}

type PropertyRowSet struct {
	// cRows:   Encodes the RowCount field of the PropertyRowSet data structures. This value
	// MUST NOT exceed 100,000.
	RowsCount uint32 `idl:"name:cRows" json:"rows_count"`
	// aRow:  Encodes the Rows field of the PropertyRowSet data structure.
	Row []*PropertyRow `idl:"name:aRow;size_is:(cRows)" json:"row"`
}

type PropertyTagArray struct {
	// cValues:  Encodes the Count field of PropTagArray. This field MUST NOT exceed 100,000.
	ValuesCount uint32 `idl:"name:cValues" json:"values_count"`
	// aulPropTag:  Encodes the PropertyTags field of PropTagArray.
	PropertyTag []uint32 `idl:"name:aulPropTag;size_is:((cValues+1));length_is:(cValues)" json:"property_tag"`
}

type PropertyValue struct {
	// ulPropTag:  Encodes the proptag of the property whose value is represented by the
	// PropertyValue_r data structure.
	PropertyTag uint32 `idl:"name:ulPropTag" json:"property_tag"`

	// Value:  Encodes the actual value of the property represented by the PropertyValue_r
	// data structure. The type value held is specified by the Property Type of the proptag
	// in the field ulPropTag.
	Value *PropertyValueUnion `idl:"name:Value;switch_is:(ulPropTag 65535 &)" json:"value"`
	// contains filtered or unexported fields
}

type PropertyValueUnion struct {
	// Types that are assignable to Value
	//
	// *PropertyValueUnion_Int16
	// *PropertyValueUnion_Int32
	// *PropertyValueUnion_Bool
	// *PropertyValueUnion_CharString
	// *PropertyValueUnion_Binary
	// *PropertyValueUnion_String
	// *PropertyValueUnion_GUID
	// *PropertyValueUnion_DateTime
	// *PropertyValueUnion_Error
	// *PropertyValueUnion_Int16Array
	// *PropertyValueUnion_Int32Array
	// *PropertyValueUnion_CharStringArray
	// *PropertyValueUnion_BinaryArray
	// *PropertyValueUnion_GUIDArray
	// *PropertyValueUnion_StringArray
	// *PropertyValueUnion_DateTimeArray
	// *PropertyValueUnion_Reserved
	Value is_PropertyValueUnion `json:"value"`
}

type PropertyValueUnion_Binary struct {
	// bin:  PROP_VAL_UNION contains an encoding of the value of a property that can contain
	// a single binary data value. The number of bytes that can be encoded in this structure
	// is 2,097,152.
	Binary *Binary `idl:"name:bin" json:"binary"`
}

type PropertyValueUnion_BinaryArray struct {
	// MVbin:  PROP_VAL_UNION contains an encoding of the values of a property that can
	// contain multiple binary data values. The number of bytes that can be encoded in each
	// value of this structure is 2,097,152. The number of values that can be encoded in
	// this structure is 100,000.
	BinaryArray *BinaryArray `idl:"name:MVbin" json:"binary_array"`
}

type PropertyValueUnion_Bool struct {
	// b:  PROP_VAL_UNION contains an encoding of the value of a property that can contain
	// a single Boolean value. The client and server MUST NOT set this to values other than
	// 1 or 0.
	Bool uint16 `idl:"name:b" json:"bool"`
}

type PropertyValueUnion_CharString struct {
	// lpszA:  PROP_VAL_UNION contains an encoding of the value of a property that can contain
	// a single 8-bit character string value. This value is NULL-terminated.
	CharString string `idl:"name:lpszA;string" json:"char_string"`
}

type PropertyValueUnion_CharStringArray struct {
	// MVszA:  PROP_VAL_UNION contains an encoding of the values of a property that can
	// contain multiple 8-bit character string values. These string values are NULL-terminated.
	// The number of values that can be encoded in this structure is 100,000.
	CharStringArray *CharStringArray `idl:"name:MVszA" json:"char_string_array"`
}

type PropertyValueUnion_DateTime struct {
	// ft:  PROP_VAL_UNION contains an encoding of the value of a property that can contain
	// a single 64-bit integer value. The value is encoded as a FILETIME structure.
	DateTime *dtyp.Filetime `idl:"name:ft" json:"date_time"`
}

type PropertyValueUnion_DateTimeArray struct {
	// MVft:  PROP_VAL_UNION contains an encoding of the value of a property that can contain
	// multiple 64-bit integer values. The values are encoded as FILETIME structures. The
	// number of values that can be encoded in this structure is 100,000.
	DateTimeArray *DateTimeArray `idl:"name:MVft" json:"date_time_array"`
}

type PropertyValueUnion_Error struct {
	// err:  PROP_VAL_UNION contains an encoding of the value of a property that can contain
	// a single PtypErrorCode value.
	Error int32 `idl:"name:err" json:"error"`
}

type PropertyValueUnion_GUID struct {
	// lpguid:  PROP_VAL_UNION contains an encoding of the value of a property that can
	// contain a single GUID value. The value is encoded as a FlatUID_r data structure.
	GUID *FlatUID `idl:"name:lpguid" json:"guid"`
}

type PropertyValueUnion_GUIDArray struct {
	// MVguid:  PROP_VAL_UNION contains an encoding of the values of a property that can
	// contain multiple GUID values. The values are encoded as FlatUID_r data structures.
	// The number of values that can be encoded in this structure is 100,000.
	GUIDArray *FlatUIDArray `idl:"name:MVguid" json:"guid_array"`
}

type PropertyValueUnion_Int16 struct {
	// i:  PROP_VAL_UNION contains an encoding of the value of a property that can contain
	// a single 16-bit integer value.
	Int16 int16 `idl:"name:i" json:"int16"`
}

type PropertyValueUnion_Int16Array struct {
	// MVi:  PROP_VAL_UNION contains an encoding of the values of a property that can contain
	// multiple 16-bit integer values. The number of values that can be encoded in this
	// structure is 100,000.
	Int16Array *ShortArray `idl:"name:MVi" json:"int16_array"`
}

type PropertyValueUnion_Int32 struct {
	// l:  PROP_VAL_UNION contains an encoding of the value of a property that can contain
	// a single 32-bit integer value.
	Int32 int32 `idl:"name:l" json:"int32"`
}

type PropertyValueUnion_Int32Array struct {
	// MVl:  PROP_VAL_UNION contains an encoding of the values of a property that can contain
	// multiple 32-bit integer values. The number of values that can be encoded in this
	// structure is 100,000.
	Int32Array *LongArray `idl:"name:MVl" json:"int32_array"`
}

type PropertyValueUnion_Reserved struct {
	// contains filtered or unexported fields
}

type PropertyValueUnion_String struct {
	// lpszW:  PROP_VAL_UNION contains an encoding of the value of a property that can contain
	// a single Unicode string value. This value is NULL-terminated.
	String string `idl:"name:lpszW;string" json:"string"`
}

type PropertyValueUnion_StringArray struct {
	// MVszW:  PROP_VAL_UNION contains an encoding of the values of a property that can
	// contain multiple Unicode string values. These string values are NULL-terminated.
	// The number of values that can be encoded in this structure is 100,000.
	StringArray *StringArray `idl:"name:MVszW" json:"string_array"`
}

type QueryColumnsRequest struct {
	// hRpc: An RPC context handle as specified in section 2.3.9.
	Handle *Handle `idl:"name:hRpc" json:"handle"`
	// dwFlags: A DWORD value containing a set of bit flags. The server MUST ignore values
	// other than the bit flag NspiUnicodeProptypes.
	Flags uint32 `idl:"name:dwFlags" json:"flags"`
}

type QueryColumnsResponse struct {
	// ppColumns: A reference to a PropertyTagArray_r structure. On return, contains a list
	// of proptags.
	Columns *PropertyTagArray `idl:"name:ppColumns" json:"columns"`
	// Return: The NspiQueryColumns return value.
	Return int32 `idl:"name:Return" json:"return"`
}

type QueryRowsRequest struct {
	// hRpc: An RPC context handle as specified in section 2.3.9.
	Handle *Handle `idl:"name:hRpc" json:"handle"`
	// dwFlags:  A DWORD value, containing a set of bit flags. The server MUST ignore values
	// other than the bit flags fEphID and fSkipObjects.
	Flags uint32 `idl:"name:dwFlags" json:"flags"`
	// pStat: A pointer to a STAT block describing a logical position in a specific address
	// book container. This parameter is used to specify both input parameters from the
	// client and return values from the NSPI server.
	Stat *Stat `idl:"name:pStat" json:"stat"`
	// dwETableCount: A DWORD value containing the number values in the input parameter
	// lpETable. This value is limited to 100,000.
	ETableCount uint32 `idl:"name:dwETableCount" json:"e_table_count"`
	// lpETable:  An array of DWORD values, representing an Explicit Table (see Explicit
	// Tables (section 3.1.1.3.2)).
	ETable []uint32 `idl:"name:lpETable;size_is:(dwETableCount);pointer:unique" json:"e_table"`
	// Count: A DWORD value containing the number of rows the client is requesting.
	Count uint32 `idl:"name:Count" json:"count"`
	// pPropTags: The value NULL or a reference to a PropertyTagArray_r value, containing
	// a list of the proptags of the properties that client requires to be returned for
	// each row returned.
	PropertyTags *PropertyTagArray `idl:"name:pPropTags;pointer:unique" json:"property_tags"`
}

type QueryRowsResponse struct {
	// pStat: A pointer to a STAT block describing a logical position in a specific address
	// book container. This parameter is used to specify both input parameters from the
	// client and return values from the NSPI server.
	Stat *Stat `idl:"name:pStat" json:"stat"`
	// ppRows: A reference to a PropertyRowSet_r value. Contains the address book container
	// rows the server returns in response to the request.
	Rows *PropertyRowSet `idl:"name:ppRows" json:"rows"`
	// Return: The NspiQueryRows return value.
	Return int32 `idl:"name:Return" json:"return"`
}

type ResolveNamesRequest struct {
	// hRpc: An RPC context handle as specified in section 2.3.9.
	Handle *Handle `idl:"name:hRpc" json:"handle"`
	// pStat: A reference to a STAT block describing a logical position in a specific address
	// book container.
	Stat *Stat `idl:"name:pStat" json:"stat"`
	// pPropTags: The value NULL or a reference to a PropertyTagArray_r value containing
	// a list of the proptags of the columns that the client requests to be returned for
	// each row returned.
	PropertyTags *PropertyTagArray `idl:"name:pPropTags;pointer:unique" json:"property_tags"`
	// paStr: A StringsArray_r value. Specifies the values the client is requesting the
	// server to do ANR on. The server MUST apply any necessary character set conversion
	// as specified in String Handling (section 3.1.1.2).
	Strings *CharStringsArray `idl:"name:paStr" json:"strings"`
}

type ResolveNamesResponse struct {
	// ppMIds: A PropertyTagArray_r value. On return, contains a list of MIds matching the
	// array of strings, as specified in the input parameter paStr.
	MIDs *PropertyTagArray `idl:"name:ppMIds" json:"m_ids"`
	// ppRows: A reference to a PropertyRowSet_r value. Contains the address book container
	// rows that the server returns in response to the request.
	Rows *PropertyRowSet `idl:"name:ppRows" json:"rows"`
	// Return: The NspiResolveNames return value.
	Return int32 `idl:"name:Return" json:"return"`
}

type ResolveNamesWRequest struct {
	// hRpc: An RPC context handle as specified in section 2.3.9.
	Handle *Handle `idl:"name:hRpc" json:"handle"`
	// pStat: A reference to a STAT block describing a logical position in a specific address
	// book container.
	Stat *Stat `idl:"name:pStat" json:"stat"`
	// pPropTags: The value NULL or a reference to a PropertyTagArray_r containing a list
	// of the proptags of the columns that the client requests to be returned for each row
	// returned.
	PropertyTags *PropertyTagArray `idl:"name:pPropTags;pointer:unique" json:"property_tags"`
	// paWStr: A WStringsArray_r value. Specifies the values on which the client is requesting
	// that the server perform ANR. The server MUST apply any necessary character set conversion
	// as specified in String Handling (section 3.1.1.2).
	Strings *StringsArray `idl:"name:paWStr" json:"strings"`
}

type ResolveNamesWResponse struct {
	// ppMIds: A PropertyTagArray_r value. On return, contains a list of MIds matching the
	// array of strings, as specified in the input parameter paWStr
	MIDs *PropertyTagArray `idl:"name:ppMIds" json:"m_ids"`
	// ppRows: A reference to a PropertyRowSet_r. Contains the address book container rows
	// that the server returns in response to the request.
	Rows *PropertyRowSet `idl:"name:ppRows" json:"rows"`
	// Return: The NspiResolveNamesW return value.
	Return int32 `idl:"name:Return" json:"return"`
}

type ResortRestrictionRequest struct {
	// hRpc: An RPC context handle as specified in section 2.3.9.
	Handle *Handle `idl:"name:hRpc" json:"handle"`
	// pStat: A reference to a STAT block describing a logical position in a specific address
	// book container.
	Stat *Stat `idl:"name:pStat" json:"stat"`
	// pInMIds: A PropertyTagArray_r value. It holds a list of MIds that comprise a restricted
	// address book container.
	InMIDs *PropertyTagArray `idl:"name:pInMIds" json:"in_m_ids"`
	// ppOutMIds: A PropertyTagArray_r value. On return, it holds a list of MIds that comprise
	// a restricted address book container.
	OutMIDs *PropertyTagArray `idl:"name:ppOutMIds" json:"out_m_ids"`
}

type ResortRestrictionResponse struct {
	// pStat: A reference to a STAT block describing a logical position in a specific address
	// book container.
	Stat *Stat `idl:"name:pStat" json:"stat"`
	// ppOutMIds: A PropertyTagArray_r value. On return, it holds a list of MIds that comprise
	// a restricted address book container.
	OutMIDs *PropertyTagArray `idl:"name:ppOutMIds" json:"out_m_ids"`
	// Return: The NspiResortRestriction return value.
	Return int32 `idl:"name:Return" json:"return"`
}

type Restriction struct {
	// rt:  Encodes the RestrictType field common to all restriction structures.
	RestrictionType uint32 `idl:"name:rt" json:"restriction_type"`
	// res:  Encodes the actual restriction specified by the type in the rt field.
	Restriction *RestrictionUnion `idl:"name:res;switch_is:rt" json:"restriction"`
}

type RestrictionUnion struct {
	// Types that are assignable to Value
	//
	// *RestrictionUnion_And
	// *RestrictionUnion_Or
	// *RestrictionUnion_Not
	// *RestrictionUnion_Content
	// *RestrictionUnion_Property
	// *RestrictionUnion_CompareProperties
	// *RestrictionUnion_BitMask
	// *RestrictionUnion_Size
	// *RestrictionUnion_Exist
	// *RestrictionUnion_SubRestriction
	Value is_RestrictionUnion `json:"value"`
}

type RestrictionUnion_And struct {
	// resAnd:  RestrictionUnion_r contains an encoding of an AndRestriction.
	And *AndRestriction `idl:"name:resAnd" json:"and"`
}

type RestrictionUnion_BitMask struct {
	// resBitMask:  RestrictionUnion_r contains an encoding of a BitMaskRestriction.
	BitMask *BitMaskRestriction `idl:"name:resBitMask" json:"bit_mask"`
}

type RestrictionUnion_CompareProperties struct {
	// resCompareProps:  RestrictionUnion_r contains an encoding of a CompareRestriction.
	CompareProperties *ComparePropertiesRestriction `idl:"name:resCompareProps" json:"compare_properties"`
}

type RestrictionUnion_Content struct {
	// resContent:  RestrictionUnion_r contains an encoding of a ContentRestriction.
	Content *ContentRestriction `idl:"name:resContent" json:"content"`
}

type RestrictionUnion_Exist struct {
	// resExist:  RestrictionUnion_r contains an encoding of an ExistRestriction.
	Exist *ExistRestriction `idl:"name:resExist" json:"exist"`
}

type RestrictionUnion_Not struct {
	// resNot:  RestrictionUnion_r contains an encoding of a NotRestriction.
	Not *NotRestriction `idl:"name:resNot" json:"not"`
}

type RestrictionUnion_Or struct {
	// resOr:  RestrictionUnion_r contains an encoding of an OrRestriction.
	Or *OrRestriction `idl:"name:resOr" json:"or"`
}

type RestrictionUnion_Property struct {
	// resProperty:  RestrictionUnion_r contains an encoding of a PropertyRestriction.
	Property *PropertyRestriction `idl:"name:resProperty" json:"property"`
}

type RestrictionUnion_Size struct {
	// resSize:  RestrictionUnion_r contains an encoding of a SizeRestriction.
	Size *SizeRestriction `idl:"name:resSize" json:"size"`
}

type RestrictionUnion_SubRestriction struct {
	// resSubRestriction:  RestrictionUnion_r contains an encoding of a SubRestriction.
	SubRestriction *SubRestriction `idl:"name:resSubRestriction" json:"sub_restriction"`
}

type SeekEntriesRequest struct {
	// hRpc:  An RPC context handle as specified in section 2.3.9.
	Handle *Handle `idl:"name:hRpc" json:"handle"`
	// pStat: A pointer to a STAT block describing a logical position in a specific address
	// book container. This parameter is used to both specify input parameters from the
	// client and return values from the NSPI server.
	Stat *Stat `idl:"name:pStat" json:"stat"`
	// pTarget: A PropertyValue_r value holding the value that is being sought.
	Target *PropertyValue `idl:"name:pTarget" json:"target"`
	// lpETable: The value NULL or a PropertyTagArray_r value. It holds a list of Mids that
	// comprises a restricted address book container.
	ETable *PropertyTagArray `idl:"name:lpETable;pointer:unique" json:"e_table"`
	// pPropTags: The value NULL or a reference to a PropertyTagArray_r value. Contains
	// list of the proptags of the columns that client wants to be returned for each row
	// returned.
	PropertyTags *PropertyTagArray `idl:"name:pPropTags;pointer:unique" json:"property_tags"`
}

type SeekEntriesResponse struct {
	// pStat: A pointer to a STAT block describing a logical position in a specific address
	// book container. This parameter is used to both specify input parameters from the
	// client and return values from the NSPI server.
	Stat *Stat `idl:"name:pStat" json:"stat"`
	// ppRows: A reference to a PropertyRowSet_r value. Contains the address book container
	// rows the server returns in response to the request.
	Rows *PropertyRowSet `idl:"name:ppRows" json:"rows"`
	// Return: The NspiSeekEntries return value.
	Return int32 `idl:"name:Return" json:"return"`
}

type ShortArray struct {
	// cValues:  The number of 16-bit integer values represented in the ShortArray_r structure.
	// This value MUST NOT exceed 100,000.
	ValuesCount uint32 `idl:"name:cValues" json:"values_count"`
	// lpi:  The 16-bit integer values.
	Values []int16 `idl:"name:lpi;size_is:(cValues)" json:"values"`
}

type SizeRestriction struct {
	// relop:  Encodes the RelOp field of the SizeRestriction data structure.
	Op uint32 `idl:"name:relop" json:"op"`
	// ulPropTag:  Encodes the PropTag field of the SizeRestriction data structure.
	PropertyTag uint32 `idl:"name:ulPropTag" json:"property_tag"`
	// cb:  Encodes the Size field of the SizeRestriction data structure.
	Length uint32 `idl:"name:cb" json:"length"`
}

type Stat struct {
	// SortType:  This field contains a DWORD representing a sort order. The client sets
	// this field to specify the sort type of this table. Possible values are specified
	// in Table Sort Orders (section 2.2.10). The server MUST NOT modify this field.
	SortType uint32 `idl:"name:SortType" json:"sort_type"`
	// ContainerID:  This field contains a MId. The client sets this field to specify the
	// MId of the address book container that this STAT represents. The client obtains these
	// MIds from the server's address book hierarchy table. The server MUST NOT modify this
	// field in any NSPI method except NspiGetMatches.
	ContainerID uint32 `idl:"name:ContainerID" json:"container_id"`
	// CurrentRec:  This field contains a MId. The client sets this field to specify a beginning
	// position in the table for the start of an NSPI method. The server sets this field
	// to report the end position in the table after processing an NSPI method.
	CurrentRecord uint32 `idl:"name:CurrentRec" json:"current_record"`
	// Delta:  This field contains a long value. The client sets this field to specify an
	// offset from the beginning position in the table for the start of an NSPI method.
	// If the NSPI method returns a success value, the server MUST set this field to 0.
	Delta int32 `idl:"name:Delta" json:"delta"`
	// NumPos:  This field contains a DWORD value specifying a position in the table. The
	// client sets this field to specify a fractional position for the beginning position
	// in the table for the start of an NSPI method (section 3.1.1.4.2). The server sets
	// this field to specify the approximate fractional position at the end of an NSPI method.
	// This value is a zero index; the first element in a table has the numeric position
	// 0. Although the protocol places no boundary or requirements on the accuracy of the
	// approximation the server reports, it is recommended that implementations maximize
	// the accuracy of the approximation to improve usability of the NSPI server for clients.
	PosLength uint32 `idl:"name:NumPos" json:"pos_length"`
	// TotalRecs:  This field contains a DWORD specifying the number of rows in the table.
	// The client sets this field to specify a fractional position for the beginning position
	// in the table for the start of an NSPI method (section 3.1.1.4.2). The server sets
	// this field to specify the total number of rows in the table. Unlike the NumPos field,
	// the server MUST report this number accurately; an approximation is insufficient.
	TotalRecords uint32 `idl:"name:TotalRecs" json:"total_records"`
	// CodePage:  This field contains a DWORD value representing a codepage. The client
	// sets this field to specify the codepage the client uses for non-Unicode strings.
	// The server MUST use this value during string handling (section 3.1.1.2). The server
	// MUST NOT modify this field.
	CodePage uint32 `idl:"name:CodePage" json:"code_page"`
	// TemplateLocale:  This field contains a DWORD value representing a language code identifier
	// (LCID). The client sets this field to specify the LCID associated with the template
	// the client wishes the server to return. The server MUST NOT modify this field.
	TemplateLocale uint32 `idl:"name:TemplateLocale" json:"template_locale"`
	// SortLocale:  This field contains a DWORD value representing an LCID. The client sets
	// this field to specify the LCID that it wishes the server to use when sorting any
	// strings. The server MUST use this value during sorting (section 3.1.1.2). The server
	// MUST NOT modify this field.
	SortLocale uint32 `idl:"name:SortLocale" json:"sort_locale"`
}

type StringArray struct {
	// cValues:  The number of Unicode character strings references represented in the WStringArray_r
	// structure. This value MUST NOT exceed 100,000.
	ValuesCount uint32 `idl:"name:cValues" json:"values_count"`
	// lppszW:  The Unicode character string references. The strings referred to are NULL-terminated.
	Values []string `idl:"name:lppszW;size_is:(cValues);string" json:"values"`
}

type StringsArray struct {
	// Count:  The number of character strings structures in this aggregation. The value
	// MUST NOT exceed 100,000.
	Count uint32 `idl:"name:Count" json:"count"`
	// Strings:  The list of wchar_t type strings in this aggregation. The strings in this
	// list are NULL-terminated.
	Strings string `idl:"name:Strings;size_is:(Count);string" json:"strings"`
}

type SubRestriction struct {
	// ulSubObject:  Encodes the SubObject field of the SubObjectRestriction data structure.
	SubObject uint32 `idl:"name:ulSubObject" json:"sub_object"`
	// lpRes:  Encodes the Restriction field of the SubObjectRestriction data structure.
	Restriction *Restriction `idl:"name:lpRes" json:"restriction"`
}

type UnbindRequest struct {
	// contextHandle: An RPC context handle as specified in section 2.3.9.
	ContextHandle *Handle `idl:"name:contextHandle" json:"context_handle"`
}

type UnbindResponse struct {
	// contextHandle: An RPC context handle as specified in section 2.3.9.
	ContextHandle *Handle `idl:"name:contextHandle" json:"context_handle"`
	// Return: The NspiUnbind return value.
	Return uint32 `idl:"name:Return" json:"return"`
}

type UpdateStatRequest struct {
	// hRpc: An RPC context handle as specified in section 2.3.9.
	Handle *Handle `idl:"name:hRpc" json:"handle"`
	// pStat: A pointer to a STAT block describing a logical position in a specific address
	// book container. This parameter is used to specify both input parameters from the
	// client and return values from the NSPI server.
	Stat *Stat `idl:"name:pStat" json:"stat"`
	// plDelta: The value NULL or a pointer to a long value indicating movement within the
	// address book container specified by the input parameter pStat.
	Delta int32 `idl:"name:plDelta;pointer:unique" json:"delta"`
}

type UpdateStatResponse struct {
	// pStat: A pointer to a STAT block describing a logical position in a specific address
	// book container. This parameter is used to specify both input parameters from the
	// client and return values from the NSPI server.
	Stat *Stat `idl:"name:pStat" json:"stat"`
	// plDelta: The value NULL or a pointer to a long value indicating movement within the
	// address book container specified by the input parameter pStat.
	Delta int32 `idl:"name:plDelta;pointer:unique" json:"delta"`
	// Return: The NspiUpdateStat return value.
	Return int32 `idl:"name:Return" json:"return"`
}