IMAPITable::QueryColumns

Gilt für: Outlook 2013 | Outlook 2016

Gibt eine Liste der Spalten für die Tabelle zurück.

HRESULT QueryColumns(
ULONG ulFlags,
LPSPropTagArray FAR * lpPropTagArray
);

Parameter

ulFlags

[in] Bitmaske von Flags, die angibt, welcher Spaltensatz zurückgegeben werden soll. Das folgende Flag kann festgelegt werden:

TBL_ALL_COLUMNS

Die Tabelle sollte alle verfügbaren Spalten zurückgeben.

lpPropTagArray

[out] Zeiger auf eine SPropTagArray-Struktur , die die Eigenschaftstags für den Spaltensatz enthält.

Rückgabewert

S_OK

Der Spaltensatz wurde erfolgreich zurückgegeben.

MAPI_E_BUSY

Ein weiterer Vorgang wird ausgeführt, der verhindert, dass der Abrufvorgang für Spaltensätze gestartet wird. Entweder sollte der laufende Vorgang abgeschlossen oder beendet werden.

Hinweise

Die IMAPITable::QueryColumns-Methode kann aufgerufen werden, um Folgendes abzurufen:

• Der Standardspaltensatz für eine Tabelle.

• Der aktuelle Spaltensatz für eine Tabelle, wie durch einen Aufruf der IMAPITable::SetColumns-Methode festgelegt.

• Der vollständige Spaltensatz für eine Tabelle, die Spalten, die verfügbar sind, aber nicht unbedingt Teil des aktuellen Satzes sind.

Hinweise für Aufrufer

Wenn Sie das TBL_ALL_COLUMNS-Flag nicht festlegen, gibt IMAPITable::QueryColumns entweder den Standardspaltensatz oder den aktuellen Spaltensatz einer Tabelle zurück, je nachdem, ob die Tabelle von einem Aufruf von IMAPITable::SetColumns betroffen ist. SetColumns ändert die Reihenfolge und Auswahl der Spalten im Spaltensatz einer Tabelle.

Wenn Sie das TBL_ALL_COLUMNS-Flag festlegen, gibt QueryColumns alle Spalten zurück, die im Spaltensatz der Tabelle enthalten sein können.

Geben Sie den Arbeitsspeicher für das Eigenschaftentagarray frei, auf das der lpPropTagArray-Parameter verweist, indem Sie die MAPIFreeBuffer-Funktion aufrufen.

MFCMAPI-Referenz

Einen MFCMAP-Beispielcode finden Sie in der folgenden Tabelle.

Siehe auch

IMAPITable::SetColumns

MAPIFreeBuffer

SPropTagArray

IMAPITable : IUnknown

MFCMAPI (engl.) als ein Codebeispiel