IMsgStore::GetReceiveFolderTable
Gilt für: Outlook 2013 | Outlook 2016
Bietet Zugriff auf die Empfangsordnertabelle, eine Tabelle, die Informationen zu allen Empfangsordnern für den Nachrichtenspeicher enthält.
HRESULT GetReceiveFolderTable(
ULONG ulFlags,
LPMAPITABLE FAR * lppTable );
Parameter
ulFlags
[in] Eine Bitmaske von Flags, die den Tabellenzugriff steuert. Die folgenden Flags können festgelegt werden:
MAPI_DEFERRED_ERRORS
Ermöglicht die erfolgreiche Rückgabe von GetReceiveFolderTable , möglicherweise bevor die Tabelle für den Aufrufer vollständig verfügbar ist. Wenn die Tabelle nicht vollständig verfügbar ist, kann durch einen nachfolgenden Tabellenaufruf ein Fehler ausgelöst werden.
MAPI_UNICODE
Die zurückgegebenen Zeichenfolgen liegen im Unicode-Format vor. Wenn das MAPI_UNICODE-Flag nicht festgelegt ist, liegen die Zeichenfolgen im ANSI-Format vor.
lppTable
[out] Ein Zeiger auf einen Zeiger auf die Empfangsordnertabelle.
Rückgabewert
S_OK
Die Empfangsordnertabelle wurde erfolgreich zurückgegeben.
Hinweise
Die IMsgStore::GetReceiveFolderTable-Methode bietet Zugriff auf eine Tabelle, die die Eigenschafteneinstellungen für alle Empfangsordner des Nachrichtenspeichers anzeigt.
Hinweise für Implementierer
Eine Liste der erforderlichen Spalten in einer Empfangsordnertabelle finden Sie unter Empfangsordnertabellen.
Implementieren Sie Ihre Empfangsordnertabellen, um das Festlegen von Eigenschaftseinschränkungen für die eigenschaft PR_RECORD_KEY (PidTagRecordKey) zu unterstützen. Dies ermöglicht einen einfachen Zugriff auf bestimmte Empfangsordner.
Hinweise für Aufrufer
Das Festlegen des MAPI_UNICODE-Flags im ulFlags-Parameter wirkt sich auf das Format der Spalten aus, die von den Methoden IMAPITable::QueryColumns und IMAPITable::QueryRows zurückgegeben werden. Dieses Flag steuert auch die Eigenschaftstypen in der Sortierreihenfolge, die von der IMAPITable::QuerySortOrder-Methode zurückgegeben wird.
MFCMAPI-Referenz
Einen MFCMAP-Beispielcode finden Sie in der folgenden Tabelle.
| Datei | Funktion | Kommentar |
|---|---|---|
| MsgStoreDlg.cpp |
CMsgStoreDlg::OnDisplayReceiveFolderTable |
MFCMAPI verwendet die IMsgStore::GetReceiveFolderTable-Methode , um die anzuzeigende Empfangsordnertabelle abzurufen. |