Fonction NdrStubCall2 (rpcndr.h)

La fonction NdrStubCall2 est le point d’entrée côté serveur pour les stubs en mode /Oicf .

Syntaxe

long NdrStubCall2(
  [in]      void          *pThis,
  [in]      void          *pChannel,
  [in, out] PRPC_MESSAGE  pRpcMsg,
  [out]     unsigned long *pdwStubPhase
);

Paramètres

[in] pThis

Pointeur vers un instance de l’objet CStdStubBuffer, implémentant IRpcStubBuffer, pour l’interface DCOM. Définissez la valeur NULL pour les interfaces RPC non-objet.

[in] pChannel

Pointeur vers IRpcChannelBuffer pour l’interface DCOM, souvent fournie par OLE. Définissez sur NULL pour les interfaces non-objet.

[in, out] pRpcMsg

Pointeur vers une structure de RPC_MESSAGE qui contient des informations sur la demande RPC. Dans les interfaces non-objet, pRpcMsg contient également des informations sur la méthode de communication à distance.

[out] pdwStubPhase

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

Valeur retournée

Retourne S_OK en cas de réussite. Déclenche une exception en cas d’erreur.

Remarques

L’exécution RPC ou l’exécution OLE appelle NdrStubCall2 pour appeler la routine du gestionnaire de serveur. Les paramètres [out] sont marshalés et retournés à l’exécution RPC ou à l’exécution OLE pour les renvoyer au client.

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 .

Valeur Description
STUB_UNMARSHAL Le stub est en phase de marshaling.
STUB_CALL_SERVER Le stub appelle une routine de gestionnaire de serveur.
STUB_MARSHAL Le stub est en phase de démarshalling.
STUB_CALL_SERVER_NO_HRESULT Obsolète. Pour les stubs déconseillés uniquement.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau | Applications UWP]
Plateforme cible Windows
En-tête rpcndr.h (inclure Rpc.h)
Bibliothèque Rpcrt4.lib
DLL Rpcrt4.dll