IMAPISession::GetMsgStoresTable
Gilt für: Outlook 2013 | Outlook 2016
Bietet Zugriff auf die Nachrichtenspeichertabelle, die Informationen zu allen Nachrichtenspeichern im Sitzungsprofil enthält.
HRESULT GetMsgStoresTable(
ULONG ulFlags,
LPMAPITABLE FAR * lppTable
);
Parameter
ulFlags
[in] Eine Bitmaske von Flags, die das Format für Spalten bestimmt, die Zeichenfolgen sind. Das folgende Flag kann festgelegt werden:
MAPI_UNICODE
Die Zeichenfolgenspalten weisen das Unicode-Format auf. Wenn das MAPI_UNICODE-Flag nicht festgelegt ist, liegen die Zeichenfolgenspalten im ANSI-Format vor.
lppTable
[out] Ein Zeiger auf einen Zeiger auf die Nachrichtenspeichertabelle.
Rückgabewert
S_OK
Die Tabelle wurde erfolgreich zurückgegeben.
MAPI_E_BAD_CHARWIDTH
Das MAPI_UNICODE-Flag wurde festgelegt, und die Sitzung unterstützt unicode nicht.
Hinweise
Die IMAPISession::GetMsgStoresTable-Methode ruft einen Zeiger auf die Nachrichtenspeichertabelle ab, eine von MAPI verwaltete Tabelle, die Informationen zu jedem geöffneten Nachrichtenspeicher im Profil enthält.
Eine vollständige Liste der erforderlichen und optionalen Spalten in der Nachrichtenspeichertabelle finden Sie unter Nachrichtenspeichertabellen.
Hinweise für Aufrufer
Da MAPI die Nachrichtenspeichertabelle während der Sitzung aktualisiert, wenn Änderungen auftreten, rufen Sie die Advise-Methode der Nachrichtenspeichertabelle auf, um sich zu registrieren, um über diese Änderungen benachrichtigt zu werden. Mögliche Änderungen umfassen das Hinzufügen neuer Nachrichtenspeicher, das Entfernen vorhandener Speicher und Änderungen am Standardspeicher.
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 |
|---|---|---|
| MainDlg.cpp |
CMainDlg::OnOpenMessageStoreTable |
MFCMAPI verwendet die IMAPISession::GetMsgStoresTable-Methode, um die Nachrichtenspeichertabelle abzurufen, damit sie im Dialogfeld Standard von MFCMAPI gerendert werden kann. |