Partilhar via


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 são chamados no contexto.

[in] riid

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

[in] iMethod

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

[in] pUnk

Esse parâmetro é reservado e deve ser NULL.

Valor de retorno

Esse método pode retornar os valores de retorno 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.

Observações

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

Para fornecer as informações de infraestrutura, é necessário especificar um número de interface e método. 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 estiver definido como IID_IEnterActivityWithNoLock, a função será executada sem um bloqueio de atividade.

Se riid estiver 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 finalidade geral.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP]
servidor com suporte mínimo Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP]
da Plataforma de Destino Windows
cabeçalho ctxtcall.h

Consulte também

IContextCallback