WrapStoreEntryID

S’applique à : Outlook 2013 | Outlook 2016

Convertit l’identificateur d’entrée interne d’une banque de messages en identificateur d’entrée plus utilisable par le système de messagerie.

Propriété	Valeur
Fichier d’en-tête :	Mapidefs.h
Implémenté par :	MAPI
Appelé par :	Applications clientes et fournisseurs de services

WrapStoreEntryID(
  ULONG ulFlags,
  LPSTR szDLLName,
  ULONG cbOrigEntry,
  LPENTRYID lpOrigEntry,
  ULONG * lpcbWrappedEntry,
  LPENTRYID * lppWrappedEntry
);

Paramètres

ulFlags

[in] Masque de bits des indicateurs. L’indicateur suivant peut être défini :

MAPI_UNICODE

Les chaînes sont au format Unicode. Si l’indicateur MAPI_UNICODE n’est pas défini, les chaînes sont au format ANSI.

szDLLName

[in] Nom de la DLL du fournisseur de magasin de messages.

cbOrigEntry

[in] Taille, en octets, de l’identificateur d’entrée d’origine pour la banque de messages.

lpOrigEntry

[in] Pointeur vers une structure ENTRYID qui contient l’identificateur d’entrée d’origine.

lpcbWrappedEntry

[out] Pointeur vers la taille, en octets, du nouvel identificateur d’entrée.

lppWrappedEntry

[out] Pointeur vers un pointeur vers une structure ENTRYID qui contient le nouvel identificateur d’entrée.

Valeur renvoyée

Aucun.

Remarques

Un objet de magasin de messages conserve un identificateur d’entrée interne qui n’est significatif que pour les fournisseurs de services coresident avec cette banque de messages. Pour les autres composants de messagerie, MAPI fournit une version encapsulée de l’identificateur d’entrée interne qui le rend reconnaissable comme appartenant à la banque de messages. Les fournisseurs de services Coresident doivent toujours recevoir l’identificateur d’entrée de magasin de messages non encapsulé d’origine ; les applications clientes doivent toujours recevoir la version encapsulée, qui est ensuite utilisable n’importe où dans le domaine de messagerie et dans d’autres domaines.

Un fournisseur de services peut encapsuler un identificateur d’entrée de magasin de messages à l’aide de la fonction WrapStoreEntryID ou de la méthode IMAPISupport ::WrapStoreEntryID , qui appelle la fonction WrapStoreEntryID . Le fournisseur doit encapsuler l’identificateur d’entrée lors de l’exposition de la propriété PR_ENTRYID (PidTagEntryId) de la banque de messages ou de son écriture dans une section de profil et lors de l’exposition de la propriété PR_STORE_ENTRYID (PidTagStoreEntryId). MAPI encapsule un identificateur d’entrée de magasin de messages lors de la réponse à un appel IMAPISession ::OpenMsgStore .

Lorsqu’une application cliente passe un identificateur d’entrée de magasin de messages encapsulé à MAPI, par exemple dans un appel IMAPISession ::OpenEntry , MAPI désencapsit l’identificateur d’entrée avant de l’utiliser pour appeler une méthode de fournisseur telle que IMSProvider ::Logon ou IMSProvider ::CompareStoreIDs.