CALLERRELEASE

Gilt für: Outlook 2013 | Outlook 2016

Definiert eine Rückruffunktion, die ein Tabellendatenobjekt freigeben kann, wenn eine Tabellenansicht freigegeben wird.

Eigenschaft	Wert
Headerdatei	Mapiutil.h
Definierte Funktion implementiert von:	Clientanwendungen und Dienstanbieter
Definierte Funktion aufgerufen von:	MAPI

void CALLERRELEASE(
  ULONG_PTR ulCallerData,
  LPTABLEDATA lpTblData,
  LPMAPITABLE lpVue
);

Parameter

ulCallerData

[in] Aufruferdaten, die von MAPI mit der Tabellenansicht gespeichert und an die CALLERRELEASE-basierte Rückruffunktion übergeben werden. Die Daten stellen kontextbezogene Informationen zur Tabellenansicht bereit, die freigegeben wird.

lpTblData

[in] Zeiger auf die ITableData: IUnknown-Schnittstelle für das Tabellendatenobjekt, das der veröffentlichten Tabellenansicht zugrunde liegt.

lpVue

[in] Zeiger auf die IMAPITable: IUnknown-Schnittstelle für die Tabellenansicht, die freigegeben wird. Dies ist eine Schnittstelle für das Tabellenobjekt, das im lppMAPITable-Parameter der ITableData::HrGetView-Methode zurückgegeben wird, die das freizugebende Objekt erstellt hat.

Rückgabewert

Keine

Hinweise

Eine Clientanwendung oder ein Dienstanbieter, der ein Tabellendatenobjekt aufgefüllt hat, kann ITableData::HrGetView aufrufen, um eine schreibgeschützte, sortierte Ansicht der Tabelle zu erstellen. Der Aufruf von HrGetView übergibt einen Zeiger an eine CALLERRELEASE-basierte Rückruffunktion sowie einen Kontext, der mit der Tabellenansicht gespeichert werden soll. Wenn die Verweisanzahl der Tabellenansicht auf 0 (null) zurückgesetzt wird und die Sicht freigegeben wird, ruft die IMAPITable-Implementierung die Rückruffunktion auf und übergibt den Kontext im ulCallerData-Parameter .

Eine CALLERRELEASE-basierte Rückruffunktion wird häufig verwendet, um das zugrunde liegende Tabellendatenobjekt freizugeben und es während der nachfolgenden Verarbeitung nicht nachverfolgen zu müssen.