Partager via


IMAPISession::GetMsgStoresTable

S’applique à : Outlook 2013 | Outlook 2016

Fournit l’accès à la table de la banque de messages qui contient des informations sur toutes les banques de messages dans le profil de session.

HRESULT GetMsgStoresTable(
  ULONG ulFlags,
  LPMAPITABLE FAR * lppTable
);

Paramètres

ulFlags

[in] Masque de bits d’indicateurs qui détermine le format des colonnes qui sont des chaînes de caractères. 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 de la banque de messages.

Valeur renvoyée

S_OK

La table a été retournée avec succès.

MAPI_E_BAD_CHARWIDTH

L’indicateur MAPI_UNICODE a été défini et la session ne prend pas en charge Unicode.

Remarques

La méthode IMAPISession ::GetMsgStoresTable récupère un pointeur vers la table de la banque de messages, une table gérée par MAPI qui contient des informations sur chaque magasin de messages ouvert dans le profil.

Pour obtenir la liste complète des colonnes obligatoires et facultatives dans la table de la banque de messages, consultez Tables du magasin de messages.

Remarques pour les appelants

Étant donné que MAPI met à jour la table de la banque de messages au cours de la session chaque fois que des modifications se produisent, appelez la méthode Advise de la table de la banque de messages pour vous inscrire afin d’être informé de ces modifications. Les modifications possibles incluent l’ajout de nouvelles banques de messages, la suppression des magasins existants et les modifications apportées au magasin par défaut.

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 .

Référence MFCMAPI

Pour voir un exemple de code MFCMAPI, consultez le tableau suivant.

Fichier Fonction Commentaire
MainDlg.cpp
CMainDlg ::OnOpenMessageStoreTable
MFCMAPI utilise la méthode IMAPISession ::GetMsgStoresTable pour obtenir la table de la banque de messages afin qu’elle puisse être affichée dans la boîte de dialogue main de MFCMAPI.

Voir aussi

IMAPISession::OpenMsgStore

IMAPITable : IUnknown

IMAPITable::QueryColumns

IMAPITable::QueryRows

IMAPITable::QuerySortOrder

IMAPITable::SetColumns

IMAPITable::SortTable

IMAPISession : IUnknown

MFCMAPI comme un exemple de Code

Tables de la banque de messages