HrDecomposeEID
S’applique à : Outlook 2013 | Outlook 2016
Sépare l’identificateur d’entrée composé d’un objet, généralement un message dans une banque de messages, en l’identificateur d’entrée de cet objet dans le magasin et l’identificateur d’entrée du magasin.
Propriété | Valeur |
---|---|
Fichier d’en-tête : |
Mapiutil.h |
Implémenté par : |
MAPI |
Appelé par : |
Applications clientes |
HrDecomposeEID(
LPMAPISESSION psession,
ULONG cbEID,
LPENTRYID pEID,
ULONG FAR * pcbStoreEID,
LPENTRYID FAR * ppStoreEID,
ULONG FAR * pcbMsgEID,
LPENTRYID FAR * ppMsgEID
);
Paramètres
psession
[in] Pointeur vers la session utilisée par l’application cliente.
cbEID
[in] Taille, en octets, de l’identificateur d’entrée composé à séparer.
pEID
[in] Pointeur vers l’identificateur d’entrée composée à séparer.
pcbStoreEID
[out] Pointeur vers la taille retournée, en octets, de l’identificateur d’entrée de la banque de messages qui contient l’objet. Si le paramètre pEID pointe vers un identificateur d’entrée non défini, le paramètre pcbStoreEID pointe vers une valeur zéro.
ppStoreEID
[out] Pointeur vers un pointeur vers l’identificateur d’entrée retourné de la banque de messages qui contient l’objet . Si le paramètre pEID pointe vers un identificateur d’entrée non défini, NULL est retourné dans le paramètre ppStoreEID .
pcbMsgEID
[out] Pointeur vers la taille retournée, en octets, de l’identificateur d’entrée de l’objet. Si le paramètre pEID pointe vers un identificateur d’entrée non défini, le paramètre pcbMsgEID est égal à la valeur du paramètre cbEID .
ppMsgEID
[out] Pointeur vers un pointeur vers l’identificateur d’entrée retourné de l’objet. Si le paramètre pEID pointe vers un identificateur d’entrée non défini, ppMsgEID pointe vers un pointeur vers une copie de l’identificateur d’entrée non défini.
Valeur renvoyée
Aucun.
Remarques
Si l’identificateur spécifié par le paramètre pEID est composé, il est divisé en identificateur d’entrée de l’objet dans sa banque de messages et en identificateur d’entrée du magasin. Les chaînes d’identificateur d’entrée non composées sont simplement copiées. L’identificateur composé à séparer est généralement créé par la fonction HrComposeEID .
Remarques pour les appelants
La mémoire qui contient le paramètre pEID est libérée lors de l’exécution réussie de cette fonction. L’implémentation appelante est chargée de libérer de la mémoire pour les paramètres de sortie.