Partager via


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