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.
| Eigenschaft | Wert |
|---|---|
| Headerdatei |
Mapiutil.h |
| Implementiert von: |
MAPI |
| Aufgerufen von: |
Clientanwendungen und Dienstanbieter |
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_IMAPITableData. Die Übergabe von NULL im lpInterface-Parameter bewirkt auch, dass das im lppTableData-Parameter zurückgegebene Tabellendatenobjekt in die Standardschnittstelle für ein Tabellendatenobjekt umgewandelt wird.
lpAllocateBuffer
[in] Zeiger auf die MAPIAllocateBuffer-Funktion , die zum Zuweisen von Arbeitsspeicher verwendet werden soll.
lpAllocateMehr
[in] Zeiger auf die MAPIAllocateMore-Funktion , die zum Zuweisen 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 für eine Clientanwendung oder einen Dienstanbieter als Teil der IMAPITable::GetStatus verfügbar ist, 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 Eigenschaftstags enthält, die die eigenschaften angeben, die in der Tabelle erforderlich sind, 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 Eingabeparameter lpAllocateBuffer, lpAllocateMore und lpFreeBuffer verweisen auf die Funktionen MAPIAllocateBuffer, MAPIAllocateMore und MAPIFreeBuffer . Eine Clientanwendung, die CreateTable aufruft, übergibt Zeiger an die soeben benannten MAPI-Funktionen. Ein Dienstanbieter übergibt die Zeiger auf diese Funktionen, die er in seinem Initialisierungsaufruf empfangen oder mit einem Aufruf der IMAPISupport::GetMemAllocRoutines-Methode abgerufen hat.