Função NdrStubForwardingFunction (rpcproxy.h)

A função NdrStubForwardingFunction é o ponto de entrada para métodos de objeto do lado do servidor definidos em uma interface base.

Sintaxe

void NdrStubForwardingFunction(
  [in]      IRpcStubBuffer    *This,
  [in]      IRpcChannelBuffer *pChannel,
  [in, out] PRPC_MESSAGE      pmsg,
  [out]     DWORD             *pdwStubPhase
);

Parâmetros

[in] This

Ponteiro para uma instância do objeto CStdStubBuffer, implementando IRpcStubBuffer, para a interface DCOM.

[in] pChannel

Ponteiro para IRpcChannelBuffer para a interface DCOM, geralmente fornecida pelo OLE.

[in, out] pmsg

Ponteiro para uma estrutura de RPC_MESSAGE que contém informações sobre a solicitação RPC.

[out] pdwStubPhase

Ponteiro para um sinalizador que rastreia a atividade da chamada do interpretador atual.

Retornar valor

Nenhum

Comentários

O parâmetro pdwStubPhase é usado pela interface do objeto para determinar o comportamento de tratamento de exceção. A tabela a seguir descreve os valores possíveis para o parâmetro pdwStubPhase .

Para métodos definidos em uma interface base, o RPC precisa encaminhar o código para a implementação da interface base.

Por exemplo:

Interface IFunctionSample: IUnknown

{

HRESULT FunctionSample();

}

Interface IOperation: IFunctionSample

{

HRESULT Operation();

}

Neste exemplo, em que IFunctionSample e IOperation são definidos em arquivos .idl diferentes. IFunctionSample é a interface base e IOperation é a interface derivada. A IOperation pode agregar IOperation sem implementar IOperation::FunctionSample. Quando o cliente chama IOperation::FunctionSample, no lado do servidor, o RPC encaminha a chamada para IFunctionSample:FunctionSample.

Requisitos