Fonction NdrStubForwardingFunction (rpcproxy.h)

La fonction NdrStubForwardingFunction est le point d’entrée pour les méthodes d’objet côté serveur qui sont définies dans une interface de base.

Syntaxe

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

Paramètres

[in] This

Pointeur vers un instance de l’objet CStdStubBuffer, implémentant IRpcStubBuffer, pour l’interface DCOM.

[in] pChannel

Pointeur vers IRpcChannelBuffer pour l’interface DCOM, souvent fournie par OLE.

[in, out] pmsg

Pointeur vers une structure RPC_MESSAGE qui contient des informations sur la requête RPC.

[out] pdwStubPhase

Pointeur vers un indicateur qui suit l’activité de l’appel d’interpréteur actuel.

Valeur de retour

None

Remarques

Le paramètre pdwStubPhase est utilisé par l’interface objet pour déterminer le comportement de gestion des exceptions. Le tableau suivant décrit les valeurs possibles pour le paramètre pdwStubPhase .

Pour les méthodes définies dans une interface de base, RPC doit transférer le code à l’implémentation de l’interface de base.

Par exemple :

Interface IFunctionSample: IUnknown

{

HRESULT FunctionSample();

}

Interface IOperation: IFunctionSample

{

HRESULT Operation();

}

Dans cet exemple, où IFunctionSample et IOperation sont définis dans différents fichiers .idl. IFunctionSample est l’interface de base et IOperation est l’interface dérivée. IOperation peut agréger IOperation sans implémenter IOperation ::FunctionSample. Lorsque le client appelle IOperation ::FunctionSample, côté serveur, RPC transfère l’appel à IFunctionSample :FunctionSample.

Configuration requise