HrComposeMsgID
S’applique à : Outlook 2013 | Outlook 2016
Crée une chaîne ASCII représentant 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 |
HrComposeMsgID(
LPMAPISESSION psession,
ULONG cbStoreRecordKey,
LPBYTE pStoreRecordKey,
ULONG cbMsgEID,
LPENTRYID pMsgEID,
LPSTR FAR * pszMsgID
);
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 qui contient le message ou un autre objet. Si zéro est passé dans le paramètre cbStoreRecordKey , le paramètre pszMsgID pointe vers une copie de l’identificateur d’entrée converti en texte.
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.
pszMsgID
[out] Pointeur vers la chaîne ASCII retournée. Si le paramètre cbStoreRecordKey est supérieur à zéro, le paramètre pszMsgID pointe vers un identificateur d’entrée composé converti en texte. Si cbStoreRecordKey est égal à zéro, pszMsgID pointe vers un identificateur d’entrée sans composant converti en texte.
Valeur renvoyée
Aucun.
Remarques
Si le message ou tout autre objet pour lequel l’identificateur d’entrée composée est créé réside dans une banque de messages, la chaîne d’identificateur est créée à 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 le paramètre cbStoreRecordKey est égal à zéro, l’identificateur d’entrée de l’objet est simplement copié et converti en chaîne.
Appeler la fonction HrComposeMsgID revient à appeler la fonction HrComposeEID , puis la fonction HrSzFromEntryID .
HrComposeMsgID permet aux applications clientes d’utiliser des objets dans plusieurs magasins via l’utilisation d’identificateurs d’entrée composés. Une application peut appeler la fonction HrDecomposeMsgID pour fractionner l’identificateur d’entrée composée en ses composants d’origine.