IContextCallback::ContextCallback-Methode (ctxtcall.h)

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

Weitere Informationen

IContextCallback