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