Fonction RpcEpUnregister (rpcdce.h)

La fonction RpcEpUnregister supprime les informations d’adresse du serveur de la base de données de carte de point de terminaison locale.

Syntaxe

RPC_STATUS RpcEpUnregister(
  RPC_IF_HANDLE      IfSpec,
  RPC_BINDING_VECTOR *BindingVector,
  UUID_VECTOR        *UuidVector
);

Paramètres

IfSpec

Interface pour annuler l’inscription à partir de la base de données de carte de point de terminaison locale.

BindingVector

Pointeur vers un vecteur de handles de liaison pour annuler l’inscription.

UuidVector

Pointeur vers un vecteur facultatif d’UUIDs d’objet pour annuler l’inscription. L’application serveur construit ce vecteur. RpcEpUnregister annule l’inscription de tous les éléments de base de données endpoint-map qui correspondent aux paramètres IfSpec et BindingVector spécifiés et aux UUID de l’objet.

Une valeur de paramètre null indique qu’il n’y a pas d’UUID d’objet à désinscrire.

Valeur retournée

Valeur	Signification
RPC_S_OK	L’appel a réussi.
RPC_S_NO_BINDINGS	Aucune liaison.
RPC_S_INVALID_BINDING	Le handle de liaison n’était pas valide.
RPC_S_WRONG_KIND_OF_BINDING	Il s’agissait du mauvais type de liaison pour l’opération.

 

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

 

Remarques

La fonction RpcEpUnregister supprime des éléments de la base de données endpoint-map de l’hôte local. Une application serveur appelle cette fonction uniquement lorsque le serveur a des points de terminaison précédemment inscrits et que le serveur souhaite supprimer ces informations d’adresse de la base de données endpoint-map.

Plus précisément, RpcEpUnregister permet à une application serveur de supprimer ses propres éléments de base de données de carte de point de terminaison (informations d’adresse de serveur) en fonction de la spécification de l’interface ou à la fois de la spécification d’interface et des UUID d’objet des ressources proposées.

Le serveur appelle la fonction RpcServerInqBindings pour obtenir le paramètre BindingVector requis. Pour annuler l’inscription des points de terminaison sélectionnés, le serveur peut tailler le vecteur de liaison avant d’appeler cette fonction.

RpcEpUnregister crée un produit croisé à partir des paramètres IfSpec, BindingVector et UuidVector et supprime chaque élément du produit croisé de la base de données endpoint-map.

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

RpcEpRegister

RpcEpRegisterNoReplace

RpcNsBindingUnexport

RpcServerInqBindings