HrComposeEID
S’applique à : Outlook 2013 | Outlook 2016
Crée un identificateur d’entrée composé pour un objet, généralement un message dans une banque de messages.
| Propriété | Valeur |
|---|---|
| Fichier d’en-tête : |
Mapiutil.h |
| Implémenté par : |
MAPI |
| Appelé par : |
Applications clientes |
HrComposeEID(
LPMAPISESSION psession,
ULONG cbStoreRecordKey,
LPBYTE pStoreRecordKey,
ULONG cbMsgEID,
LPENTRYID pMsgEID,
ULONG FAR * pcbEID,
LPENTRYID FAR * ppEID
);
Paramètres
psession
[in] Pointeur vers la session utilisée par l’application cliente.
cbStoreRecordKey
[in] Taille, en octets, de la clé d’enregistrement de la banque de messages contenant le message ou un autre objet. Si zéro est passé dans le paramètre cbStoreRecordKey , le paramètre ppEID pointe vers une copie de l’identificateur d’entrée de l’objet.
pStoreRecordKey
[in] Pointeur vers la clé d’enregistrement de la banque de messages qui contient le message ou un autre objet.
cbMsgEID
[in] Taille, en octets, de l’identificateur d’entrée du message ou d’un autre objet.
pMsgEID
[in] Pointeur vers l’identificateur d’entrée de l’objet.
pcbEID
[out] Pointeur vers la taille, en octets, de l’identificateur retourné.
ppEID
[out] Pointeur vers un pointeur vers l’identificateur d’entrée retourné. Si la valeur du paramètre cbStoreRecordKey est supérieure à zéro, le paramètre ppEID pointe vers un pointeur vers l’identificateur d’entrée composé créé. Si cbStoreRecordKey est égal à zéro, ppEID pointe vers un pointeur vers une copie de l’identificateur d’entrée de l’objet.
Valeur renvoyée
Aucun.
Remarques
Si le message ou tout autre objet pour lequel l’identificateur d’entrée composé est créé réside dans une banque de messages, l’identificateur est créé à partir de l’identificateur d’entrée de l’objet et de la clé d’enregistrement du magasin. Si l’objet n’est pas dans un magasin, c’est-à-dire si le nombre d’octets pour la clé d’enregistrement du magasin passé dans cbStoreRecordKey est égal à zéro, l’identificateur d’entrée de l’objet est simplement copié.
La fonction HrComposeEID permet aux applications d’utiliser des objets dans plusieurs magasins via l’utilisation d’identificateurs d’entrée composés. Une application peut appeler la fonction HrDecomposeEID pour fractionner l’identificateur d’entrée composée en ses composants d’origine.