IMAPISession::GetStatusTable
S’applique à : Outlook 2013 | Outlook 2016
Fournit l’accès à la table status, une table qui contient des informations sur toutes les ressources MAPI dans la session.
HRESULT GetStatusTable(
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 status.
Valeur renvoyée
S_OK
La table a été retournée avec succès.
Remarques
La méthode IMAPISession ::GetStatusTable permet d’accéder à la table status qui contient des informations sur toutes les ressources MAPI de la session. Le tableau contient une ligne pour les informations sur le sous-système MAPI, une ligne pour le spouleur MAPI, une ligne pour le carnet d’adresses intégré et une ligne pour chaque fournisseur de services dans le profil.
Pour obtenir la liste complète des colonnes obligatoires et facultatives dans la table status, consultez Tables d’état.
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 ::OnStatusTable |
MFCMAPI utilise la méthode IMAPISession ::GetStatusTable pour obtenir la table status à afficher. |