IMAPITable::GetStatus
Gilt für: Outlook 2013 | Outlook 2016
Gibt die status und den Typ der Tabelle zurück.
HRESULT GetStatus(
ULONG FAR * lpulTableStatus,
ULONG FAR * lpulTableType
);
Parameter
lpulTableStatus
[out] Zeiger auf einen Wert, der die status der Tabelle angibt. Einer der folgenden Werte kann zurückgegeben werden:
TBLSTAT_COMPLETE
Es werden keine Vorgänge ausgeführt.
TBLSTAT_QCHANGED
Der Inhalt der Tabelle wurde erwartungsgemäß geändert. Dieser status Wert wird für Änderungen, die sich aus Sortier- oder Einschränkungsvorgängen ergeben, nicht zurückgegeben.
TBLSTAT_RESTRICT_ERROR
Fehler während eines IMAPITable::Restrict-Vorgangs .
TBLSTAT_RESTRICTING
Ein IMAPITable::Restrict-Vorgang wird ausgeführt.
TBLSTAT_SETCOL_ERROR
Fehler während eines IMAPITable::SetColumns-Vorgangs .
TBLSTAT_SETTING_COLS
Ein IMAPITable::SetColumns-Vorgang wird ausgeführt.
TBLSTAT_SORT_ERROR
Fehler während eines IMAPITable::SortTable-Vorgangs .
TBLSTAT_SORTING
Ein IMAPITable::SortTable-Vorgang wird ausgeführt.
lpulTableType
[out] Zeiger auf einen Wert, der den Typ der Tabelle angibt. Einer der folgenden drei Tabellentypen kann zurückgegeben werden:
TBLTYPE_DYNAMIC
Der Inhalt der Tabelle ist dynamisch; Die Zeilen- und Spaltenwerte können sich ändern, wenn sich die zugrunde liegenden Daten ändern.
TBLTYPE_KEYSET
Die Zeilen in der Tabelle sind fest, aber die Werte der Spalten in diesen Zeilen sind dynamisch und können sich ändern, wenn sich die zugrunde liegenden Daten ändern.
TBLTYPE_SNAPSHOT
Die Tabelle ist statisch, und ihr Inhalt ändert sich nicht, wenn sich die zugrunde liegenden Daten ändern.
Rückgabewert
S_OK
Die status der Tabelle wurde erfolgreich zurückgegeben.
Hinweise
Die IMAPTable::GetStatus-Methode ruft Informationen zum Typ und zum aktuellen status einer Tabelle ab.
Hinweise für Aufrufer
Sie können GetStatus in Verbindung mit drei anderen IMAPITable-Methoden verwenden, um die status dieser Vorgänge zu überwachen und die Auswirkungen auf die Tabelle zu bestimmen. Rufen Sie GetStatus auf, nachdem Sie einen der folgenden IMAPITable-Aufrufe ausgeführt haben:
IMAPITable::Restrict , um eine Einschränkung festzulegen.
IMAPITable::SortTable zum Einrichten einer Sortierreihenfolge.
IMAPITable::SetColumns zum Definieren eines Spaltensatzes.
MFCMAPI-Referenz
Einen MFCMAP-Beispielcode finden Sie in der folgenden Tabelle.
| Datei | Funktion | Kommentar |
|---|---|---|
| ContentsTableListCtrl.cpp |
CContentsTableListCtrl::GetStatus |
MFCMAPI verwendet die IMAPITable::GetStatus-Methode, um die status einer Tabelle zu melden. |