Método ICallFrameEvents::OnCall (callobj.h)

Informa o coletor de eventos se ele receber uma chamada de método no interceptador. O coletor é fornecido com uma instância ICallFrame que está associada à invocação de método de entrada interceptada. Por meio desse coletor, o quadro de chamada pode ser manipulado de várias maneiras.

Sintaxe

HRESULT OnCall(
  [in] ICallFrame *pFrame
);

Parâmetros

[in] pFrame

Um quadro de chamada associado à invocação recebida.

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.
E_UNEXPECTED	Ocorreu um erro inesperado.

Comentários

No retorno de OnCall, o interceptador pressupõe que, por alguns meios, os valores de saída do método foram inicializados adequadamente conforme necessário, se houver; O interceptador não manipula ainda mais o quadro de chamada de forma alguma. Normalmente, a implementação de OnCall terá definido os valores de saída por alguns meios, seja invocando o quadro de chamada em um objeto, cancelando com êxito alguns valores de marshaling anteriormente ou limpando-os com ICallFrame::Free.

O valor retornado também deve ter sido definido adequadamente durante a chamada de maneira semelhante. Consulte 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

ICallFrameEvents