IMAPISupport::GetOneOffTable
S’applique à : Outlook 2013 | Outlook 2016
Retourne un pointeur vers la table unique MAPI (liste de modèles pris en charge par tous les fournisseurs de carnets d’adresses pour la création de nouveaux destinataires).
HRESULT GetOneOffTable(
ULONG ulFlags,
LPMAPITABLE FAR * lppTable
);
Paramètres
ulFlags
[in] Masque de bits d’indicateurs qui contrôle le type des colonnes de chaîne. 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.
Remarques
La méthode IMAPISupport ::GetOneOffTable est implémentée pour les objets de prise en charge du fournisseur de carnets d’adresses. Les fournisseurs de carnets d’adresses appellent GetOneOffTable pour récupérer la liste complète des modèles de création de nouveaux destinataires. Ce tableau inclut les modèles des fournisseurs de carnets d’adresses actifs dans la prise en charge de session, ainsi que les modèles pris en charge par MAPI.
Les destinataires nouvellement créés peuvent être utilisés pour traiter un message ou ajoutés à un conteneur de carnet d’adresses.
Pour obtenir la liste des propriétés qui composent l’ensemble de colonnes requis dans les tables ponctuelles, consultez Tables ponctuelles.
La définition de l’indicateur MAPI_UNICODE dans le paramètre ulFlags affecte le format des colonnes retournées par les méthodes IMAPITable ::QueryColumns et IMAPITable ::QueryRows . Cet indicateur contrôle également les types de propriétés dans l’ordre de tri retourné par la méthode IMAPITable ::QuerySortOrder .
Remarques pour les appelants
Si vous êtes inscrit pour recevoir des notifications de modifications apportées à cette table unique, vous recevrez également des notifications de modifications apportées aux tables ponctuelles d’autres fournisseurs. En fonction de ces notifications, vous pouvez prendre en charge les nouveaux types d’adresses qui sont ajoutés pendant la session active.