Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

3.1.4.13 NspiDNToMId (Opnum 7)

The NspiDNToMId method maps a set of DN to a set of MId.

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.3.9.

Reserved: A DWORD value reserved for future use. Ignored by the server.

pNames: A StringsArray_r value. It holds a list of strings containing DNs, according to [MS-OXOABK].

ppMIds: A PropertyTagArray_r value. On return, it holds a list of MIds.

Return Values: The server returns a long value specifying the return status of the method.

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

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<28> make additional validations as described in Security (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 MId, it MUST map the DN to a MId with the value 0.

  4. The server constructs a list of MIds 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.

 
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.