IMAPISupport::WrapStoreEntryID
S’applique à : Outlook 2013 | Outlook 2016
Convertit l’identificateur d’entrée interne d’une banque de messages en identificateur d’entrée au format standard MAPI.
HRESULT WrapStoreEntryID(
ULONG cbOrigEntry,
LPENTRYID lpOrigEntry,
ULONG FAR * lpcbWrappedEntry,
LPENTRYID FAR * lppWrappedEntry
);
Paramètres
cbOrigEntry
[in] Nombre d’octets dans l’identificateur d’entrée vers lequel pointe le paramètre lpOrigEntry .
lpOrigEntry
[in] Pointeur vers l’identificateur d’entrée privée pour la banque de messages.
lpcbWrappedEntry
[out] Pointeur vers le nombre d’octets dans l’identificateur d’entrée vers lequel pointe le paramètre lppWrappedEntry .
lppWrappedEntry
[out] Pointeur vers un pointeur vers l’identificateur d’entrée encapsulé.
Valeur renvoyée
S_OK
L’identificateur d’entrée a été correctement encapsulé.
Remarques
La méthode IMAPISupport ::WrapStoreEntryID est implémentée pour tous les objets de prise en charge du fournisseur de services. Les fournisseurs de services utilisent WrapStoreEntryID pour que MAPI génère un identificateur d’entrée pour une banque de messages qui encapsule l’identificateur d’entrée interne du magasin.
Remarques pour les appelants
Lorsqu’un client appelle la méthode IMAPIProp ::GetProps de votre magasin de messages pour récupérer sa propriété PR_STORE_ENTRYID (PidTagStoreEntryId) et que votre magasin de messages utilise un identificateur d’entrée dans un format privé, appelez WrapStoreEntryID et retournez l’identificateur d’entrée vers lequel pointe le paramètre lppWrappedEntry .
Les appels aux méthodes IMSProvider ::Logon et IMSLogon ::CompareEntryIDs obtiennent toujours l’identificateur d’entrée privée du magasin . la version encapsulée est utilisée uniquement entre les applications clientes et MAPI.
Libérez la mémoire pour l’identificateur d’entrée pointé par le paramètre lppWrappedEntry à l’aide de la fonction MAPIFreeBuffer lorsque vous avez terminé d’utiliser l’identificateur d’entrée.