HrDecomposeMsgID

S’applique à : Outlook 2013 | Outlook 2016

Sépare la représentation ASCII de 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

HrDecomposeMsgID(
  LPMAPISESSION psession,
  LPSTR szMsgID,
  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.

szMsgID

[in] Chaîne représentant l’identificateur d’entrée de l’objet.

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 szMsgID pointe vers une chaîne d’identificateur d’entrée non définie, le paramètre pcbStoreEID pointe vers 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 szMsgID 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 dans son magasin. Si le paramètre szMsgID pointe vers une chaîne d’identificateur d’entrée non définie, le paramètre pcbMsgEID est égal à la valeur du paramètre cbEID .

ppMsgEID

[out] Pointeur vers un pointeur vers la chaîne d’identificateur d’entrée retournée de l’objet dans son magasin. Si le paramètre szMsgID pointe vers un identificateur d’entrée non défini, ppMsgEID pointe vers un pointeur vers une copie convertie de l’identificateur d’entrée non défini.

Valeur renvoyée

Aucun.

Remarques

Si l’identificateur spécifié par le paramètre szMsgID est composé, il est converti en ASCII et divisé en l’identificateur d’entrée de l’objet dans sa banque de messages et l’identificateur d’entrée du magasin. Les chaînes d’identificateur d’entrée non composées sont simplement converties et copiées. La chaîne d’identificateur composée à séparer est généralement créée par la fonction HrComposeMsgID .

Appeler la fonction HrDecomposeMsgID revient à appeler la fonction HrEntryIDFromSz , puis la fonction HrDecomposeEID .