Fonction NdrStubCall2 (rpcndr.h)

Article
03/01/2024

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

Partager via