RpcServerRegisterIf, fonction (rpcdce.h)

Article
03/04/2024

La fonction RpcServerRegisterIf inscrit une interface auprès de la bibliothèque d’exécution RPC.

Syntaxe

RPC_STATUS RpcServerRegisterIf(
  RPC_IF_HANDLE IfSpec,
  UUID          *MgrTypeUuid,
  RPC_MGR_EPV   *MgrEpv
);

Paramètres

IfSpec

Structure générée par MIDL indiquant l’interface à inscrire.

MgrTypeUuid

Pointeur vers un UUID de type à associer au paramètre MgrEpv . La spécification d’une valeur de paramètre Null (ou d’un UUID nil) inscrit IfSpec avec un UUID de type nil.

MgrEpv

Le vecteur de point d’entrée (EPV) des routines du gestionnaire. Pour utiliser l’EPV par défaut généré par MIDL, spécifiez une valeur Null. Pour plus d’informations, consultez RPC_MGR_EPV.

Valeur retournée

Retourne RPC_S_OK en cas de réussite.

Note Pour obtenir la liste des codes d’erreur valides, consultez Valeurs de retour RPC.

Remarques

Un serveur peut inscrire un nombre illimité d’interfaces auprès de la bibliothèque d’exécution RPC. L’inscription met une interface à la disposition des clients à l’aide d’un handle de liaison au serveur. Pour inscrire une interface, le code de l’application serveur appelle RpcServerRegisterIf. Pour chaque implémentation d’une interface qu’un serveur propose, il doit inscrire un EPV de gestionnaire distinct.

Lors de l’appel de RpcServerRegisterIf, le serveur fournit les informations suivantes :

Spécification de l’interface
La spécification d’interface est une structure de données générée par le compilateur MIDL. Le serveur spécifie l’interface à l’aide du paramètre IfSpec .
Type de gestionnaire UUID et EPV de gestionnaire
Le type de gestionnaire UUID et l’EPV de gestionnaire déterminent quelle routine de gestionnaire s’exécute lorsqu’un serveur reçoit une demande d’appel de procédure distante d’un client.

Le serveur spécifie le type de gestionnaire UUID et EPV à l’aide des paramètres MgrTypeUuid et MgrEpv . Notez que lorsque vous spécifiez un UUID de type gestionnaire non nil, le serveur doit également appeler la fonction RpcObjectSetType pour inscrire des objets de ce type non nil.

Si votre application serveur doit inscrire une interface d’écoute automatique ou utiliser une fonction de rappel à des fins d’authentification, utilisez RpcServerRegisterIfEx.

Configuration requise

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