This topic has not yet been rated - Rate this topic

MAPIUID

Published: July 16, 2012

A byte-order independent version of a GUID structure that is used to uniquely identify a service provider.

Header file:

Mapidefs.h

Related macro:

IsEqualMAPIUID

typedef struct _MAPIUID
{
  BYTE ab[16];
} MAPIUID, FAR *LPMAPIUID;

ab

An array that contains a 16-byte identifier.

A MAPIUID structure is a GUID structure put into Intel® processor byte order.

MAPI creates MAPIUID structures in a way that makes it very rare for two different items to have the same identifier. MAPIUID structures can be stored as binary properties or as files, without regard to the byte ordering of the computer storing or accessing the information.

MAPIUID structures are used:

  • To identify a profile section.

  • In the entry identifiers of message store and address book objects to identify the responsible service provider.

  • In the PR_SEARCH_KEY (PidTagSearchKey) property of messages.

To generate a MAPIUID identifier for a search key, service providers call IMAPISupport::NewUID.

When a client transmits a message across a network, it should use a protocol or transmission format that does not change the byte order of MAPIUID data.

For more information about how MAPIUID structures are used, see the following topics:

Registering Service Provider Unique Identifiers

Setting Transport Order

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.