Funzione NdrStubForwardingFunction (rpcproxy.h)

Articolo
03/13/2024

La funzione NdrStubForwardingFunction è il punto di ingresso per i metodi oggetto lato server definiti in un'interfaccia di base.

Sintassi

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

Parametri

[in] This

Puntatore a un'istanza dell'oggetto CStdStubBuffer, implementando IRpcStubBuffer, per l'interfaccia DCOM.

[in] pChannel

Puntatore a IRpcChannelBuffer per l'interfaccia DCOM, spesso fornito da OLE.

[in, out] pmsg

Puntatore a una struttura RPC_MESSAGE che contiene informazioni sulla richiesta RPC.

[out] pdwStubPhase

Puntatore a un flag che tiene traccia dell'attività dell'interprete corrente.

Valore restituito

nessuno

Osservazioni

Il parametro pdwStubPhase viene usato dall'interfaccia dell'oggetto per determinare il comportamento di gestione delle eccezioni. La tabella seguente descrive i valori possibili per il parametro pdwStubPhase .

Valore	Descrizione
STUB_UNMARSHAL	Lo stub è in fase di marshalling.
STUB_CALL_SERVER	Lo stub chiama una routine di gestione server.
STUB_MARSHAL	Lo stub è in fase di nonmarshalling.
STUB_CALL_SERVER_NO_HRESULT	Obsoleta. Solo per gli stub deprecati.

Per i metodi definiti in un'interfaccia di base, RPC deve inoltrare il codice all'implementazione dell'interfaccia di base.

Ad esempio:

Interface IFunctionSample: IUnknown

{

HRESULT FunctionSample();

}

Interface IOperation: IFunctionSample

{

HRESULT Operation();

}

In questo esempio, dove IFunctionSample e IOperation sono definiti in file con estensione idl diversi. IFunctionSample è l'interfaccia di base e IOperation è l'interfaccia derivata. IOperation può aggregare IOperation senza implementare IOperation::FunctionSample. Quando il client chiama IOperation::FunctionSample, sul lato server RPC inoltra la chiamata a IFunctionSample:FunctionSample.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [app desktop \| App UWP]
Server minimo supportato	Windows 2000 Server [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	rpcproxy.h
Libreria	Rpcrt4.lib
DLL	Rpcrt4.dll

Condividi tramite