Compartilhar via


Método ICallFrame::Invoke (callobj.h)

Aplica esse registro de ativação a um objeto . Em uma situação de marshaling, normalmente isso é realizado no lado do servidor e é o meio pelo qual o trabalho do objeto real é realizado.

Sintaxe

HRESULT Invoke(
  [in] void *pvReceiver,
       ...  
);

Parâmetros

[in] pvReceiver

A interface na qual a invocação deve ocorrer. O chamador é responsável por garantir que essa interface seja do IID apropriado; a implementação simplesmente fará uma conversão e assumirá que esse é o caso.

...

Parâmetros adicionais.

Retornar valor

Esse método pode retornar os valores a seguir.

Código de retorno Descrição
S_OK
O método foi concluído com sucesso.
CALLFRAME_E_ALREADYINVOKED
Uma invocação já foi feita a partir desse quadro.
E_UNEXPECTED
Ocorreu um erro inesperado.

Comentários

Em geral, a execução da invocação envolve alocar um novo quadro de pilha, copiar superficialmente os dados no quadro original e, em seguida, chamar o método apropriado no objeto indicado. O objeto invocado pode optar por modificar os parâmetros [out], que podem ser acessados do quadro copiado, de acordo com a semântica apropriada da invocação. Quando a invocação retorna do objeto , o quadro de chamada captura automaticamente o valor retornado de ICallFrame::SetReturnValue.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho callobj.h

Confira também

ICallFrame