Partager via


IMAPITable::QueryColumns

S’applique à : Outlook 2013 | Outlook 2016

Retourne une liste de colonnes pour la table.

HRESULT QueryColumns(
ULONG ulFlags,
LPSPropTagArray FAR * lpPropTagArray
);

Paramètres

ulFlags

[in] Masque de bits des indicateurs qui indique le jeu de colonnes à retourner. L’indicateur suivant peut être défini :

TBL_ALL_COLUMNS

La table doit retourner toutes les colonnes disponibles.

lpPropTagArray

[out] Pointeur vers une structure SPropTagArray contenant les balises de propriété pour le jeu de colonnes.

Valeur renvoyée

S_OK

Le jeu de colonnes a été retourné avec succès.

MAPI_E_BUSY

Une autre opération est en cours qui empêche l’opération de récupération d’ensemble de colonnes de démarrer. Soit l’opération en cours doit être autorisée à se terminer, soit elle doit être arrêtée.

Remarques

La méthode IMAPITable ::QueryColumns peut être appelée pour récupérer :

  • Jeu de colonnes par défaut pour une table.

  • Jeu de colonnes actuel pour une table, tel qu’établi par un appel à la méthode IMAPITable ::SetColumns .

  • Ensemble de colonnes complet pour une table, les colonnes disponibles, mais qui ne font pas nécessairement partie de l’ensemble actuel.

Remarques pour les appelants

Si vous ne définissez pas l’indicateur TBL_ALL_COLUMNS, IMAPITable ::QueryColumns retourne le jeu de colonnes par défaut ou actuel d’une table, selon que la table a été affectée par un appel à IMAPITable ::SetColumns. SetColumns modifie l’ordre et la sélection des colonnes dans le jeu de colonnes d’une table.

Si vous définissez l’indicateur TBL_ALL_COLUMNS, QueryColumns retourne toutes les colonnes qui peuvent se trouver dans le jeu de colonnes de la table.

Libérez la mémoire du tableau de balises de propriété vers lequel pointe le paramètre lpPropTagArray en appelant la fonction MAPIFreeBuffer .

Référence MFCMAPI

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

Fichier Fonction Commentaire
ContentsTableListCtrl.cpp
CContentsTableListCtrl ::D oSetColumns
MFCMAPI utilise la méthode IMAPITable ::QueryColumns pour récupérer le jeu de colonnes actuel d’une table afin que l’utilisateur puisse la modifier.

Voir aussi

IMAPITable::SetColumns

MAPIFreeBuffer

SPropTagArray

IMAPITable : IUnknown

MFCMAPI comme un exemple de Code