IMAPISupport::CreateOneOff

Article
04/04/2023

S’applique à : Outlook 2013 | Outlook 2016

Crée un identificateur d’entrée pour une adresse unique.

HRESULT CreateOneOff(
  LPSTR lpszName,
  LPSTR lpszAdrType,
  LPSTR lpszAddress,
  ULONG ulFlags,
  ULONG FAR * lpcbEntryID,
  LPENTRYID FAR * lppEntryID
);

Paramètres

lpszName

[in] Pointeur vers le nom complet du destinataire de la propriété PR_DISPLAY_NAME (PidTagDisplayName). Le paramètre lpszName peut être NULL.

lpszAdrType

[in] Pointeur vers le type d’adresse (par exemple, FAX, SMTP ou X500) du destinataire. Le paramètre lpszAdrType ne peut pas être NULL.

lpszAddress

[in] Pointeur vers l’adresse de messagerie du destinataire. Le paramètre lpszAddress ne peut pas être NULL.

ulFlags

[in] Masque de bits d’indicateurs qui affecte le destinataire unique. Les indicateurs suivants peuvent être définis :

MAPI_SEND_NO_RICH_INFO

Le destinataire ne peut pas gérer le contenu du message mis en forme. Si MAPI_SEND_NO_RICH_INFO est défini, MAPI affecte la valeur FALSE à la propriété PR_SEND_RICH_INFO (PidTagSendRichInfo) du destinataire. Si MAPI_SEND_NO_RICH_INFO n’est pas défini, MAPI définit cette propriété sur TRUE, sauf si l’adresse de messagerie du destinataire pointée par lpszAddress est interprétée comme une adresse Internet. Dans ce cas, MAPI définit PR_SEND_RICH_INFO sur FALSE.

MAPI_UNICODE

Le nom d’affichage, le type d’adresse et l’adresse sont au format Unicode. Si l’indicateur MAPI_UNICODE n’est pas défini, ces chaînes sont au format ANSI.

lpcbEntryID

[out] Pointeur vers le nombre d’octets dans l’identificateur d’entrée vers lequel pointe le paramètre lppEntryID .

lppEntryID

[out] Pointeur vers un pointeur vers l’identificateur d’entrée du destinataire unique.

Valeur renvoyée

S_OK

L’identificateur d’entrée unique a été créé avec succès.

Remarques

La méthode IMAPISupport ::CreateOneOff est implémentée pour tous les objets de prise en charge du fournisseur de services. Les fournisseurs de services appellent CreateOneOff pour créer un identificateur d’entrée pour un destinataire unique (un destinataire qui n’appartient à aucun des conteneurs de l’un des fournisseurs de carnets d’adresses actuellement chargés).

Remarques pour les appelants

Lorsque vous avez terminé d’utiliser l’identificateur d’entrée retourné par CreateOneOff, libérez la mémoire allouée pour l’identificateur d’entrée à l’aide de la fonction MAPIFreeBuffer .

Remarques pour les fournisseurs de transport

Prenez en charge le format TNEF (Transport Neutral Encapsulation Format) et utilisez la valeur de la propriété PR_SEND_RICH_INFO pour déterminer s’il faut utiliser TNEF lors du transport d’un message. Le fait de ne pas prendre en charge TNEF ou de ne pas envoyer de message dans ce format lorsqu’il est demandé peut être un problème pour les clients basés sur les formulaires ou les clients qui nécessitent des propriétés MAPI personnalisées. Cela est dû au fait que TNEF est généralement utilisé pour envoyer des propriétés personnalisées pour les classes de messages personnalisées.

Voir aussi

MAPIFreeBuffer

Propriété canonique PidTagDisplayName

Propriété canonique PidTagSendRichInfo

IMAPISupport : IUnknown

Partager via