IMAPITable::GetCollapseState
Gilt für: Outlook 2013 | Outlook 2016
Gibt die Daten zurück, die zum Neuerstellen des aktuellen reduzierten oder erweiterten Zustands einer kategorisierten Tabelle erforderlich sind.
HRESULT GetCollapseState(
ULONG ulFlags,
ULONG cbInstanceKey,
LPBYTE lpbInstanceKey,
ULONG FAR * lpcbCollapseState,
LPBYTE FAR * lppbCollapseState
);
Parameter
ulFlags
Reserviert; muss null sein.
cbInstanceKey
[in] Die Anzahl der Bytes im instance Schlüssel, auf den der lpbInstanceKey-Parameter verweist.
lpbInstanceKey
[in] Ein Zeiger auf die PR_INSTANCE_KEY -Eigenschaft (PidTagInstanceKey) der Zeile, in der der aktuelle reduzierte oder erweiterte Zustand neu erstellt werden soll. Der lpbInstanceKey-Parameter darf nicht NULL sein.
lpcbCollapseState
[out] Ein Zeiger auf die Anzahl der Strukturen, auf die der lppbCollapseState-Parameter verweist.
lppbCollapseState
[out] Ein Zeiger auf einen Zeiger auf Strukturen, die Daten enthalten, die die aktuelle Tabellenansicht beschreiben.
Rückgabewert
S_OK
Der Status der kategorisierten Tabelle wurde erfolgreich gespeichert.
MAPI_E_BUSY
Ein weiterer Vorgang wird ausgeführt, der verhindert, dass der Vorgang gestartet wird. Entweder sollte der laufende Vorgang abgeschlossen oder beendet werden.
MAPI_E_NO_SUPPORT
Die Tabelle unterstützt keine Kategorisierung sowie erweiterte und reduzierte Ansichten.
Hinweise
Die IMAPITable::GetCollapseState-Methode arbeitet mit der IMAPITable::SetCollapseState-Methode zusammen, um die Benutzeransicht einer kategorisierten Tabelle zu ändern. GetCollapseState speichert die Daten, die von SetCollapseState benötigt werden, um die entsprechenden Ansichten der Kategorien einer kategorisierten Tabelle neu zu erstellen. Dienstanbieter bestimmen die zu speichernden Daten. Die meisten Dienstanbieter, die GetCollapseState implementieren, sparen jedoch Folgendes:
Die Sortierschlüssel (Standardspalten und Kategoriespalten).
Informationen zu der Zeile, die der instance-Schlüssel darstellt.
Informationen zum Wiederherstellen der reduzierten und erweiterten Kategorien der Tabelle.
Weitere Informationen zu kategorisierten Tabellen finden Sie unter Sortieren und Kategorisieren.
Hinweise für Implementierer
Speichern Sie den aktuellen Zustand aller Knoten einer Tabelle im lppbCollapseState-Parameter .
Hinweise für Aufrufer
Rufen Sie immer GetCollapseState auf, bevor Sie SetCollapseState aufrufen.