CreateTable

Gilt für: Outlook 2013 | Outlook 2016

Erstellt Strukturen und ein Objekthandle für ein ITableData-Objekt, das zum Erstellen von Tabelleninhalten verwendet werden kann.

SCODE CreateTable(
  LPCIID lpInterface,
  ALLOCATEBUFFER FAR * lpAllocateBuffer,
  ALLOCATEMORE FAR * lpAllocateMore,
  FREEBUFFER FAR * lpFreeBuffer,
  LPVOID lpvReserved,
  ULONG ulTableType,
  ULONG ulPropTagIndexColumn,
  LPSPropTagArray lpSPropTagArrayColumns,
  LPTABLEDATA FAR * lppTableData
);

Parameter

lpInterface

[in] Zeiger auf einen Schnittstellenbezeichner (Interface Identifier, IID) für das Tabellendatenobjekt. Der gültige Schnittstellenbezeichner ist IID_IMAPIPropData. Das Übergeben von NULL im lpInterface-Parameter bewirkt auch, dass das im lppPropData-Parameter zurückgegebene Eigenschaftsdatenobjekt in die Standardschnittstelle für ein Eigenschaftsdatenobjekt umgewandelt wird.

lpAllocateBuffer

[in] Zeiger auf die MAPIAllocateBuffer-Funktion, die zum Zuordnen von Arbeitsspeicher verwendet werden soll.

lpAllocateMore

[in] Zeiger auf die MAPIAllocateMore-Funktion, die zum Zuordnen von zusätzlichem Arbeitsspeicher verwendet werden soll.

lpFreeBuffer

[in] Zeiger auf die MAPIFreeBuffer-Funktion, die zum Freigeben von Arbeitsspeicher verwendet werden soll.

lpvReserved

[in] Reserviert. NULL muss sein.

ulTableType

[in] Ein Tabellentyp, der einer Clientanwendung oder einem Dienstanbieter als Teil von IMAPITable::GetStatus zur Verfügung steht, gibt Daten in den Tabellenansichten zurück. Die folgenden Werte sind möglich:

TBLTYPE_DYNAMIC

Der Inhalt der Tabelle ist dynamisch und kann sich ändern, wenn sich die zugrunde liegenden Daten ändern.

TBLTYPE_KEYSET

Die Zeilen in der Tabelle sind fest, aber die Werte in diesen Zeilen sind dynamisch und können sich ändern, wenn sich die zugrunde liegenden Daten ändern.

TBLTYPE_SNAPSHOT

Die Tabelle ist statisch, und der Inhalt ändert sich nicht, wenn sich die zugrunde liegenden Daten ändern.

ulPropTagIndexColumn

[in] Indexnummer der Spalte, die beim Ändern von Tabellendaten verwendet werden soll.

lpSPropTagArrayColumns

[in] Zeiger auf eine SPropTagArray-Struktur, die ein Array von Eigenschaftentags enthält, die die in der Tabelle erforderlichen Eigenschaften angeben, für die das Objekt Daten enthält.

lppTableData

[out] Zeiger auf einen Zeiger auf das zurückgegebene Tabellendatenobjekt.

Rückgabewert

S_OK

Der Aufruf erfolgreich ausgeführt und der erwartete Wert oder Werte zurückgegeben hat.

Hinweise

Die lpAllocateBuffer, lpAllocateMoreund lpFreeBuffer-Eingabeparameter zeigen auf die MAPIAllocateBuffer, MAPIAllocateMoreund MAPIFreeBuffer-Funktionen. Eine Clientanwendung, die CreateTable aufruft, übergibt Zeiger an die MAPI-Funktionen, die gerade benannt wurden. Ein Dienstanbieter übergibt die Zeiger an diese Funktionen, die er in seinem Initialisierungsaufruf empfangen oder mit einem Aufruf der IMAPISupport::GetMemAllocRoutines-Methode abgerufen hat.

Siehe auch

IMAPITable : IUnknown