IContextCallback::ContextCallback-Methode (ctxtcall.h)

Artikel
08/22/2023

Gibt den Objektkontext ein, führt die angegebene Funktion aus und gibt zurück.

Syntax

HRESULT ContextCallback(
  [in] PFNCONTEXTCALL pfnCallback,
  [in] ComCallData    *pParam,
  [in] REFIID         riid,
  [in] int            iMethod,
  [in] IUnknown       *pUnk
);

Parameter

[in] pfnCallback

Die Funktion, die innerhalb des Objektkontexts aufgerufen werden soll.

[in] pParam

Die Daten, die an die Funktion übergeben werden sollen, wenn sie im Kontext aufgerufen wird.

[in] riid

Die IID des Aufrufs, der simuliert wird. Weitere Informationen finden Sie unter Hinweise.

[in] iMethod

Die Methodennummer des aufrufs, der simuliert wird. Weitere Informationen finden Sie unter Hinweise.

[in] pUnk

Dieser Parameter ist reserviert und muss NULL sein.

Rückgabewert

Diese Methode kann die Standardrückgabewerte E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED und E_FAIL zurückgeben. Wenn keiner dieser Fehler auftritt, ist der Rückgabewert dieser Funktion der HRESULT-Wert , der von der PfnCallback-Funktion zurückgegeben wird.

Hinweise

Diese Methode simuliert einen Methodenaufruf für ein Objekt innerhalb des Kontexts. Es ist für Vorgänge auf niedriger Ebene vorgesehen, z. B. Cleanup/Lazy Marshaling, die die Erwartungen der Anwendung an die Wiedereinführung berücksichtigen.

Um die Infrastrukturinformationen zu erhalten, müssen eine Schnittstelle und eine Methodennummer angegeben werden. Der Parameter riid darf nicht IID_IUnknown werden, und die Methodennummer darf nicht kleiner als 3 sein.

Wenn riid auf IID_IEnterActivityWithNoLock festgelegt ist, wird die Funktion ohne Aktivitätssperre ausgeführt.

Wenn riid auf IID_ICallbackWithNoReentrancyToApplicationSTA festgelegt ist, wird ein ASTA von der Funktion nicht beliebig erneut ausgeführt. Die meisten Apps sollten riid für die allgemeine Verwendung auf diese Werte festlegen.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	ctxtcall.h

Weitere Informationen

IContextCallback

Freigeben über