RpcNsMgmtBindingUnexportA, fonction (rpcnsi.h)

La fonction RpcNsMgmtBindingUnexport supprime plusieurs handles de liaison et objets d’une entrée dans la base de données name-service.

Remarque Cette fonction n’est pas prise en charge sur les systèmes d’exploitation Windows Vista et ultérieurs.

 

Syntaxe

RPC_STATUS RpcNsMgmtBindingUnexportA(
  unsigned long EntryNameSyntax,
  RPC_CSTR      EntryName,
  RPC_IF_ID     *IfId,
  unsigned long VersOption,
  UUID_VECTOR   *ObjectUuidVec
);

Paramètres

EntryNameSyntax

Syntaxe de entryName.

Pour utiliser la syntaxe spécifiée dans l’entrée de valeur de Registre HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntax, fournissez une valeur de RPC_C_NS_SYNTAX_DEFAULT.

EntryName

Pointeur vers le nom de l’entrée à partir de laquelle supprimer des handles de liaison et des UUID d’objet.

IfId

Pointeur vers une identification d’interface. Une valeur de paramètre Null indique que les handles de liaison ne doivent pas être non exportés. Seuls les UUID d’objet doivent être non exportés.

VersOption

Spécifie comment la fonction RpcNsMgmtBindingUn export utilise les VersMajor et les membres VersMinor de la structure pointées par le paramètre ifId .

Le tableau suivant décrit les valeurs valides pour le paramètre VersOption .

Valeurs VersOption	Signification
RPC_C_VERS_ALL	Annule toutes les liaisons pour l’interface UUID dans IfId, quels que soient les numéros de version. Pour cette valeur, spécifiez 0 pour les versions principales et mineures dans IfId.
RPC_C_VERS_IF_ID	Annule les liaisons de l’interface compatible UUID dans IfId avec la même version principale et avec une version mineure supérieure ou égale à la version mineure dans IfId.
RPC_C_VERS_EXACT	Annule les liaisons de l’UUID de l’interface dans IfId avec les mêmes versions principales et mineures que dans IfId.
RPC_C_VERS_MAJOR_ONLY	Annule les liaisons de l’UUID de l’interface dans IfId avec la même version principale que dans IfId (ignore la version mineure). Pour cette valeur, spécifiez 0 pour la version mineure dans IfId.
RPC_C_VERS_UPTO	Annule les liaisons qui offrent une version de l’UUID d’interface spécifiée inférieure ou égale à la version principale et mineure spécifiée. (Par exemple, si les IfId contenaient V2.0 et que l’entrée de base de données de nom contenait des handles de liaison contenant les versions 1.3, 2.0 et 2.1, la fonction RpcNsMgmtBindingUnexport désexporter les handles de liaison avec les versions 1.3 et 2.0.)

ObjectUuidVec

Pointeur vers un vecteur d’UUID d’objet que le serveur ne souhaite plus offrir. L’application construit ce vecteur. Une valeur Null indique qu’il n’existe aucun UUID d’objet pour annuler l’exportation. Seuls les handles de liaison doivent être non exportés.

Valeur de retour

Valeur	Signification
RPC_S_OK	L’appel a réussi.
RPC_S_INVALID_VERS_OPTION	L’option de version n’est pas valide.
RPC_S_INVALID_NAME_SYNTAX	La syntaxe du nom n’est pas valide.
RPC_S_UNSUPPORTED_NAME_SYNTAX	La syntaxe du nom n’est pas prise en charge.
RPC_S_INCOMPLETE_NAME	Le nom est incomplet.
RPC_S_ENTRY_NOT_FOUND	L’entrée nom-service est introuvable.
RPC_S_NAME_SERVICE_UNAVAILABLE	Le service de noms n’est pas disponible.
RPC_S_INTERFACE_NOT_FOUND	L’interface est introuvable.
RPC_S_NOT_ALL_OBJS_UNEXPORTED	Tous les objets ne sont pas exportés.

 

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

 

Remarques

La fonction RpcNsMgmtBindingUnexport permet à une application de gestion de supprimer l’une des options suivantes d’une entrée de base de données de service de nom :

• Tous les handles de liaison pour un UUID d’interface spécifié, qualifiés par les numéros de version de l’interface (principaux et mineurs)
• Un ou plusieurs UUID d’objets de ressources
• Handles de liaison et UUID d’objets de ressources

Une application de gestion peut annuler l’exportation d’interfaces et d’objets dans un seul appel à RpcNsMgmtBindingUnexport, ou les exporter séparément. Si RpcNsMgmtBindingUnexport ne trouve aucun handle de liaison pour l’interface spécifiée, la fonction retourne un code d’état RPC_S_INTERFACE_NOT_FOUND et ne désexporte pas les UUID d’objet, le cas échéant.

Si un ou plusieurs handles de liaison pour l’interface spécifiée sont trouvés et non exportés sans erreur, RpcNsMgmtBindingUnexport annule les UUID d’objets spécifiés. Si l’un des UUID de l’objet spécifié n’a pas été trouvé, RpcNsMgmtBindingUnexport retourne RPC_S_NOT_ALL_OBJS_UNEXPORTED.

En plus d’appeler rpcNsMgmtBindingUnexport, une application de gestion doit également appeler la fonction RpcMgmtEpUnregister pour annuler l’inscription des serveurs inscrits auprès de la base de données endpoint-map.

Remarque bases de données name-service sont conçues pour être relativement stables. Dans les services de noms répliqués, l’utilisation fréquente des fonctions RpcNsBindingExport et RpcNsBindingUnexport entraîne la suppression répétée et le remplacement de la même entrée, ce qui peut entraîner des problèmes de performances.

 

Note

L’en-tête rpcnsi.h définit RpcNsMgmtBindingUnexport comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	rpcnsi.h (inclure Rpc.h)
bibliothèque	Rpcns4.lib
DLL	Rpcns4.dll

Voir aussi

RpcMgmtEpUnregister

RpcNsBindingExport

RpcNsBindingUnexport