IAddrBook::CreateOneOff
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 la valeur de la propriété PR_DISPLAY_NAME (PidTagDisplayName) du destinataire. Le paramètre lpszName peut être NULL.
lpszAdrType
[in] Pointeur vers le type d’adresse du destinataire, tel que FAX ou SMTP. Le paramètre lpszAdrType ne peut pas être NULL.
lpszAddress
[in] Pointeur vers l’adresse 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
Les clients appellent la méthode 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. Les destinataires ponctuels peuvent avoir n’importe quel type d’adresse pris en charge par l’un des fournisseurs de carnets d’adresses actifs pour la session.
Les destinataires ponctuels sont généralement créés avec un modèle pour leur type d’adresse particulier. Le fournisseur de carnet d’adresses qui prend en charge le type d’adresse fournit le modèle. Un utilisateur d’une application cliente entre les informations pertinentes dans le modèle.
MAPI prend en charge les chaînes de caractères Unicode pour le nom d’affichage, le type d’adresse et les paramètres d’adresse de CreateOneOff.
L’indicateur MAPI_SEND_NO_RICH_INFO détermine si du texte mis en forme au format RTF (Rich Text Format) est envoyé avec chaque message. Le format TNEF (Transport Neutral Encapsulation Format), qui est utilisé pour transmettre du texte mis en forme, est envoyé par la plupart des fournisseurs de transport, quelle que soit la façon dont le destinataire définit sa propriété PR_SEND_RICH_INFO . Ce n’est pas un problème pour les clients de messagerie qui fonctionnent avec des messages interpersonnels. Toutefois, étant donné que TNEF est généralement utilisé pour envoyer des propriétés personnalisées pour les classes de messages personnalisées, le fait de ne pas le prendre en charge peut être un problème pour les clients basés sur des formulaires ou les clients qui nécessitent des propriétés MAPI personnalisées. Pour plus d’informations, consultez Envoi de messages avec TNEF.
Référence MFCMAPI
Pour voir un exemple de code MFCMAPI, consultez le tableau suivant.
| Fichier | Fonction | Commentaire |
|---|---|---|
| Mapiabfunctions.cpp |
AddOneOffAddress |
MFCMAPI utilise la méthode CreateOneOff pour créer un ID d’entrée pour une adresse introuvable dans un carnet d’adresses. |