Método IContextCallback::ContextCallback (ctxtcall.h)

Escribe el contexto del objeto, ejecuta la función especificada y devuelve.

Sintaxis

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

Parámetros

[in] pfnCallback

Función a la que se va a llamar dentro del contexto del objeto.

[in] pParam

Los datos que se van a pasar a la función cuando se llama en el contexto.

[in] riid

IiD de la llamada que se está simulando. Vea Comentarios para obtener más información.

[in] iMethod

Número de método de la llamada que se está simulando. Vea Comentarios para obtener más información.

[in] pUnk

Este parámetro está reservado y debe ser NULL.

Valor devuelto

Este método puede devolver los valores devueltos estándar E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED y E_FAIL. Si no se produce ninguno de estos errores, el valor devuelto de esta función es el valor HRESULT devuelto por la función pfnCallback .

Comentarios

Este método simula una llamada de método en un objeto dentro del contexto. Está pensado para operaciones de bajo nivel, como limpieza y serialización diferida, que respetan las expectativas de reentrada de la aplicación.

Para proporcionar la información de infraestructura, se debe especificar una interfaz y un número de método. El parámetro riid no debe ser IID_IUnknown y el número de método no debe ser inferior a 3.

Si riid se establece en IID_IEnterActivityWithNoLock, la función se ejecuta sin un bloqueo de actividad.

Si riid se establece en IID_ICallbackWithNoReentrancyToApplicationSTA, la función no vuelve a escribir un ASTA arbitrariamente. La mayoría de las aplicaciones deben establecer riid en estos valores para uso general.

Requisitos

Consulte también

IContextCallback