IABLogon::GetOneOffTable
S’applique à : Outlook 2013 | Outlook 2016
Retourne une table de modèles ponctuels pour créer des destinataires à ajouter à la liste des destinataires d’un message sortant.
HRESULT GetOneOffTable(
ULONG ulFlags,
LPMAPITABLE FAR * lppTable
);
Paramètres
ulFlags
[in] Masque de bits d’indicateurs qui contrôle le type de colonnes de chaîne incluses dans la table. L’indicateur suivant peut être défini :
MAPI_UNICODE
Les colonnes de chaîne sont au format Unicode. Si l’indicateur MAPI_UNICODE n’est pas défini, les colonnes de chaîne sont au format ANSI.
lppTable
[out] Pointeur vers un pointeur vers la table unique.
Valeur renvoyée
S_OK
La table unique a été récupérée avec succès.
MAPI_E_BAD_CHARWIDTH
Soit l’indicateur MAPI_UNICODE a été défini et le fournisseur de carnet d’adresses ne prend pas en charge Unicode, soit MAPI_UNICODE n’a pas été défini et le fournisseur de carnet d’adresses prend uniquement en charge Unicode.
MAPI_E_NO_SUPPORT
Le fournisseur de carnet d’adresses ne fournit aucun modèle unique.
Remarques
MAPI appelle la méthode GetOneOffTable pour mettre à disposition des modèles ponctuels afin de créer des destinataires. Les nouveaux destinataires sont ajoutés à la liste des destinataires d’un message sortant. Les fournisseurs de carnets d’adresses doivent prendre en charge la notification sur leur table unique pour informer MAPI des modifications de modèle. MAPI maintient la table unique ouverte pour activer la mise à jour dynamique.
Les fournisseurs de carnets d’adresses peuvent également prendre en charge une table unique pour chacun de leurs conteneurs. Les appelants récupèrent cette table unique en appelant la méthode IMAPIProp ::OpenProperty du conteneur et en demandant la propriété PR_CREATE_TEMPLATES (PidTagCreateTemplates). Les modèles disponibles via cette table sont utilisés pour ajouter des destinataires au conteneur. Pour plus d’informations sur les différences entre les deux types de tables ponctuelles, consultez Implémentation de tables One-Off.
Pour obtenir la liste des colonnes requises dans la table unique d’un fournisseur de carnets d’adresses, consultez Tables ponctuelles.