Share via

3.1.4.1.13 NspiDNToMId (Opnum 7)

  • Article

The NspiDNToMId method maps a set of DNs to a set of Minimal Entry ID.

 long NspiDNToMId(
   [in] NSPI_HANDLE hRpc,
   [in] DWORD Reserved,
   [in] StringsArray_r* pNames,
   [out] PropertyTagArray_r** ppMIds
 );

hRpc: An RPC context handle, as specified in section 2.2.10.

Reserved: A DWORD [MS-DTYP] value reserved for future use. Ignored by the server.

pNames: A StringsArray_r value. It holds a list of strings that contain DNs, as specified in [MS-OXOABK].

ppMIds: A PropertyTagArray_r value. On return, it holds a list of Minimal Entry IDs.

Return Values: The server returns a long value that specifies 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].

Server Processing Rules: Upon receiving this message, the server MUST process the data from the message subject to the following constraints:

  1. If the server returns any return value other than "Success", the server MUST return the value NULL in the return parameter ppMIds.

  2. The server MAY make additional validations as described in section 5). If the server chooses to limit the visibility of data based on these validations, the server MUST proceed as if that data did not exist in the address book.

  3. If the server is unable to locate an appropriate mapping between a DN and a Minimal Entry ID, it MUST map the DN to a Minimal Entry ID with the value 0.

  4. The server constructs a list of Minimal Entry IDs to return to the client, encoding the mappings. The list is in a one-to-one order preserving correspondence with the list of DNs in the input parameter pNames. The server MUST return the list in the output parameter ppMIds.

  5. If no other return values have been specified by these constraints, the server MUST return the return value "Success".