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.
| Datei | Funktion | Kommentar |
|---|---|---|
| ContentsTableListCtrl.cpp |
CContentsTableListCtrl::D oSetColumns |
MFCMAPI verwendet die IMAPITable::QueryColumns-Methode , um den aktuellen Spaltensatz für eine Tabelle abzurufen, damit der Benutzer sie bearbeiten kann. |