HrAddColumnsEx
Gilt für: Outlook 2013 | Outlook 2016
Fügt Spalten am Anfang einer vorhandenen Tabelle hinzu oder verschiebt sie.
| Eigenschaft | Wert |
|---|---|
| Headerdatei |
Mapiutil.h |
| Implementiert von: |
MAPI |
| Aufgerufen von: |
Clientanwendungen und Dienstanbieter |
HRESULT HrAddColumnsEx(
LPMAPITABLE lptbl,
LPSPropTagArray lpproptagColumnsNew,
LPALLOCATEBUFFER lpAllocateBuffer,
LPFREEBUFFER lpFreeBuffer,
void (FAR * lpfnFilterColumns)(
LPSPropTagArray ptaga)
);
Parameter
lptbl
[in] Zeiger auf die betroffene MAPI-Tabelle.
lpproptagColumnsNew
[in] Zeiger auf eine SPropTagArray-Struktur , die ein Array von Eigenschaftstags für die Eigenschaften enthält, die hinzugefügt oder an den Anfang der Tabelle verschoben werden sollen.
lpAllocateBuffer
[in] Zeiger auf die MAPIAllocateBuffer-Funktion , die zum Zuweisen von Arbeitsspeicher verwendet werden soll.
lpFreeBuffer
[in] Zeiger auf die MAPIFreeBuffer-Funktion , die zum Freigeben von Arbeitsspeicher verwendet werden soll.
lpfnFilterColumns
[in] Zeiger auf eine Rückruffunktion, die vom Aufrufer bereitgestellt wird. Wenn der Parameter lpfnFilterColumns auf NULL festgelegt ist, erfolgt kein Rückruf.
ptaga
[in] Zeiger auf eine SPropTagArray-Struktur , die das Array von Eigenschaftstags enthält, das bereits in der Tabelle vorhanden ist, bevor Eigenschaften hinzugefügt oder an den Anfang verschoben werden. HrAddColumnsEx übergibt diesen Zeiger als Parameter an die Rückruffunktion, auf die von lpfnFilterColumns verwiesen wird.
Rückgabewert
S_OK
Der Aufruf war erfolgreich, und die angegebenen Spalten wurden verschoben oder hinzugefügt.
Hinweise
Die Eigenschaften, die mit dem lpproptagColumnsNew-Parameter an HrAddColumnsEx übergeben werden, werden zu den ersten Eigenschaften, die bei nachfolgenden Aufrufen der IMAPITable::QueryRows-Methode verfügbar gemacht werden. Alle Eigenschaften, die zuvor in der Tabelle nicht im lpproptagColumnsNew-Parameter angegeben wurden, werden nach allen hinzugefügten und verschobenen Eigenschaften verfügbar gemacht.
Wenn Tabelleneigenschaften beim Aufruf von QueryRows undefiniert sind, werden sie mit Eigenschaftentyp PT_NULL und Eigenschaftenbezeichner PROP_ID_NULL zurückgegeben.
Hinweise für Aufrufer
Mit der Funktion HrAddColumnsEx kann der Aufrufer eine Rückruffunktion bereitstellen, um die Spalten zu filtern, die sich bereits in der Tabelle befanden, z. B. um Zeichenfolgen vom Eigenschaftentyp PT_UNICODE in PT_STRING8 zu konvertieren. HrAddColumnsEx übergibt einen Zeiger an den zuvor vorhandenen Spaltensatz als Parameter an die Rückruffunktion. Die Rückruffunktion kann Daten im Eigenschaftentagarray ändern, aber keine neuen Tags hinzufügen.
HrAddColumnsEx ruft zuerst die Rückruffunktion auf, wenn eine eingerichtet ist, fügt dann die angegebenen Spalten hinzu oder verschiebt sie und ruft schließlich IMAPITable::SetColumns auf.
Die Eingabeparameter lpAllocateBuffer und lpFreeBuffer verweisen auf die Funktionen MAPIAllocateBuffer bzw. MAPIFreeBuffer . Die genauen Werte der an HrAddColumnsEx übergebenen Zeiger hängen davon ab, ob der Aufrufer eine Clientanwendung oder ein Dienstanbieter ist. Ein Client übergibt Zeiger an die MAPI-Funktionen mit den angegebenen Namen. Ein Dienstanbieter übergibt die Zeiger, die er in seinem Initialisierungsaufruf empfangen oder durch Aufrufen der IMAPISupport::GetMemAllocRoutines-Methode abgerufen hat.