IMsgStore::GetReceiveFolderTable
S’applique à : Outlook 2013 | Outlook 2016
Fournit l’accès à la table de dossiers de réception, une table qui inclut des informations sur tous les dossiers de réception de la banque de messages.
HRESULT GetReceiveFolderTable(
ULONG ulFlags,
LPMAPITABLE FAR * lppTable );
Paramètres
ulFlags
[in] Masque de bits d’indicateurs qui contrôle l’accès aux tables. Les indicateurs suivants peuvent être définis :
MAPI_DEFERRED_ERRORS
Permet à GetReceiveFolderTable de retourner correctement, éventuellement avant que la table ne soit entièrement disponible pour l’appelant. Si la table n’est pas entièrement disponible, un appel de table ultérieur peut générer une erreur.
MAPI_UNICODE
Les chaînes retournées sont au format Unicode. Si l’indicateur MAPI_UNICODE n’est pas défini, les chaînes sont au format ANSI.
lppTable
[out] Pointeur vers un pointeur vers la table de dossiers de réception.
Valeur renvoyée
S_OK
La table de dossiers de réception a été retournée avec succès.
Remarques
La méthode IMsgStore ::GetReceiveFolderTable permet d’accéder à une table qui affiche les paramètres de propriété de tous les dossiers de réception de la banque de messages.
Remarques pour les responsables de l’implémentation
Pour obtenir la liste des colonnes requises dans une table de dossiers de réception, consultez Recevoir des tables de dossiers.
Implémentez vos tables de dossiers de réception pour prendre en charge la définition de restrictions de propriété sur la propriété PR_RECORD_KEY (PidTagRecordKey). Cela permet d’accéder facilement à des dossiers de réception particuliers.
Remarques pour les appelants
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 |
|---|---|---|
| MsgStoreDlg.cpp |
CMsgStoreDlg ::OnDisplayReceiveFolderTable |
MFCMAPI utilise la méthode IMsgStore ::GetReceiveFolderTable pour obtenir la table de dossiers de réception à afficher. |