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. |