IMAPITable::GetStatus
S’applique à : Outlook 2013 | Outlook 2016
Retourne le status et le type de la table.
HRESULT GetStatus(
ULONG FAR * lpulTableStatus,
ULONG FAR * lpulTableType
);
Paramètres
lpulTableStatus
[out] Pointeur vers une valeur indiquant le status de la table. L’une des valeurs suivantes peut être retournée :
TBLSTAT_COMPLETE
Aucune opération n’est en cours.
TBLSTAT_QCHANGED
Le contenu de la table a changé de manière attendue. Cette valeur status n’est pas retournée pour les modifications résultant d’opérations de tri ou de restriction.
TBLSTAT_RESTRICT_ERROR
Une erreur s’est produite lors d’une opération IMAPITable ::Restrict .
TBLSTAT_RESTRICTING
Une opération IMAPITable ::Restrict est en cours.
TBLSTAT_SETCOL_ERROR
Une erreur s’est produite lors d’une opération IMAPITable ::SetColumns .
TBLSTAT_SETTING_COLS
Une opération IMAPITable ::SetColumns est en cours.
TBLSTAT_SORT_ERROR
Une erreur s’est produite lors d’une opération IMAPITable ::SortTable .
TBLSTAT_SORTING
Une opération IMAPITable ::SortTable est en cours.
lpulTableType
[out] Pointeur vers une valeur qui indique le type de la table. L’un des trois types de table suivants peut être retourné :
TBLTYPE_DYNAMIC
Le contenu de la table est dynamique ; les lignes et les valeurs de colonne peuvent changer à mesure que les données sous-jacentes changent.
TBLTYPE_KEYSET
Les lignes de la table sont fixes, mais les valeurs des colonnes de ces lignes sont dynamiques et peuvent changer à mesure que les données sous-jacentes changent.
TBLTYPE_SNAPSHOT
La table est statique et son contenu ne change pas lorsque les données sous-jacentes changent.
Valeur renvoyée
S_OK
Le status de la table a été retourné avec succès.
Remarques
La méthode IMAPTable ::GetStatus récupère des informations sur le type d’une table et la status actuelle.
Remarques pour les appelants
Vous pouvez utiliser GetStatus conjointement avec trois autres méthodes IMAPITable pour surveiller la status de ces opérations et déterminer l’effet sur la table. Appelez GetStatus après avoir effectué l’un des appels IMAPITable suivants :
IMAPITable ::Restrict pour définir une restriction.
IMAPITable ::SortTable pour établir un ordre de tri.
IMAPITable ::SetColumns pour définir un jeu de colonnes.
Référence MFCMAPI
Pour voir un exemple de code MFCMAPI, consultez le tableau suivant.
| Fichier | Fonction | Commentaire |
|---|---|---|
| ContentsTableListCtrl.cpp |
CContentsTableListCtrl ::GetStatus |
MFCMAPI utilise la méthode IMAPITable ::GetStatus pour signaler les status d’une table. |