3.1.4 Message Processing Events and Sequencing Rules

This protocol MUST indicate to the RPC runtime via the strict_context_handle property that it is to reject use of context handles created by a method of a different RPC interface than this one, as specified in [MS-RPCE].

This protocol MUST indicate to the RPC runtime via the type_strict_context_handle property that it is to reject use of context handles created by a method that creates a different type of context handle, as specified in [MS-RPCE].

This interface includes the following methods.

Methods in RPC Opnum Order

Method

Description

NspiBind

Initiate a session with the NSPI server.

Opnum: 0

NspiUnbind

Conclude a session with the NSPI server.

Opnum: 1

NspiUpdateStat

Update the logical position in a specified table.

Opnum: 2

NspiQueryRows

Return information about a set of rows in a table.

Opnum: 3

NspiSeekEntries

Seek forward in a specified table and update the logical position in that table

Opnum: 4

NspiGetMatches

Restrict a specific table based on input parameters and return the resultant Explicit Table.

Opnum: 5

NspiResortRestriction

Change the sort order of an Explicit Table.

Opnum: 6

NspiDNToMId

Translate a DN to a MId.

Opnum: 7

NspiGetPropList

Return a list of all the properties which exist on a specific object in the address book.

Opnum: 8

NspiGetProps

Return a list of properties and their values for a specific object in the address book.

Opnum: 9

NspiCompareMIds

Compare the position of two rows in a table.

Opnum: 10

NspiModProps

Modify a property of a row in the address book.

Opnum: 11

NspiGetSpecialTable

Retrieve the address book hierarchy table of the NSPI server, or retrieve the address creation table from the NSPI server.

Opnum: 12

NspiGetTemplateInfo

Retrieve addressing or display templates from the NSPI server.

Opnum: 13

NspiModLinkAtt

Modify a property of a row in the address book. Applies only to rows that support the PtypEmbeddedTable Property Type.

Opnum: 14

Opnum15NotUsedOnWire

Opnum: 15

NspiQueryColumns

Retrieve a list of all the proptags the NSPI server recognizes.

Opnum: 16

NspiGetNamesFromIDs

Retrieve the property names associated with Property IDs from the NSPI server.

Opnum: 17

NspiGetIDsFromNames

Retrieve the Property IDs associated with property names from the NSPI server.

Opnum: 18

NspiResolveNames

Perform ANR on a set of provided names. The names are specified in the codepage of the client.

Opnum: 19

NspiResolveNamesW

Perform ANR on a set of provided names. The names are specified in the Unicode character set.

Opnum: 20

No exceptions are thrown beyond those thrown by the underlying RPC protocol, as specified in [MS-RPCE].

The server MUST return the value NotEnoughMemory if unable to complete processing a method due to errors allocating memory.

The server MUST return the value OutOfResources if unable to complete processing a method due to lack of some nonmemory resource.

The server MUST return the value GeneralFailure if unable to complete processing a method for reasons other than those specified here or in the methods details.

The server MUST return the value Success if it completes without some other return value being specified in the method details.

Note Gaps in the opnum numbering sequence represent opnums that are reserved for local use. The server behavior is undefined, because it does not affect interoperability.<10>