Partager via


RpcServerRegisterIf, fonction (rpcdce.h)

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

Voir aussi

Inscription d’interfaces

RpcBindingFromStringBinding

RpcBindingSetObject

RpcNsBindingExport

RpcNsBindingImportBegin

RpcNsBindingLookupBegin

RpcObjectSetType

RpcServerRegisterIf2

RpcServerRegisterIf3

RpcServerRegisterIfEx

RpcServerUnregisterIf

RpcServerUnregisterIfEx