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

Insere o contexto do objeto, executa a função especificada e retorna.

Sintaxe

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

Parâmetros

[in] pfnCallback

A função a ser chamada dentro do contexto do objeto.

[in] pParam

Os dados a serem passados para a função quando forem chamados no contexto.

[in] riid

O IID da chamada que está sendo simulada. Confira Comentários para obter mais informações.

[in] iMethod

O número do método da chamada que está sendo simulada. Confira Comentários para obter mais informações.

[in] pUnk

Esse parâmetro é reservado e deve ser NULL.

Valor retornado

Esse método pode retornar os valores retornados padrão E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED e E_FAIL. Se nenhuma dessas falhas ocorrer, o valor retornado dessa função será o valor HRESULT retornado pela função pfnCallback .

Comentários

Esse método simula uma chamada de método em um objeto dentro do contexto. Ele destina-se a operações de baixo nível, como limpeza/marshaling lento, que respeitam as expectativas de reentrância do aplicativo.

Para fornecer as informações de infraestrutura, uma interface e um número de método devem ser especificados. O parâmetro riid não deve ser IID_IUnknown e o número do método não deve ser menor que 3.

Se riid for definido como IID_IEnterActivityWithNoLock, a função será executada sem um bloqueio de atividade.

Se riid for definido como IID_ICallbackWithNoReentrancyToApplicationSTA, a função não recuará novamente um ASTA arbitrariamente. A maioria dos aplicativos deve definir riid para esses valores para uso de uso geral.

Requisitos

Confira também

IContextCallback