RpcNsBindingExportA, fonction (rpcnsi.h)

Article
08/25/2023

La fonction RpcNsBindingExport établit une entrée de nom service-base de données avec plusieurs handles de liaison et plusieurs objets pour un serveur.

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

Syntaxe

RPC_STATUS RpcNsBindingExportA(
  unsigned long      EntryNameSyntax,
  RPC_CSTR           EntryName,
  RPC_IF_HANDLE      IfSpec,
  RPC_BINDING_VECTOR *BindingVec,
  UUID_VECTOR        *ObjectUuidVec
);

Paramètres

EntryNameSyntax

Syntaxe d’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 la valeur RPC_C_NS_SYNTAX_DEFAULT.

EntryName

Pointeur vers le nom d’entrée vers lequel les handles de liaison et les UUID d’objet sont exportés. Vous ne pouvez pas fournir une chaîne null ou vide. Le client et le serveur doivent tous deux utiliser le même nom d’entrée.

IfSpec

Structure de données générées par stub spécifiant l’interface à exporter. Une valeur Null indique qu’il n’y a pas de handles de liaison à exporter (seuls les UUID d’objets doivent être exportés) et BindingVec est ignoré.

BindingVec

Pointeur vers les liaisons de serveur à exporter. Une valeur Null indique qu’il n’y a pas de handles de liaison à exporter (seuls les UUID d’objets doivent être exportés).

ObjectUuidVec

Pointeur vers un vecteur d’UUID d’objet proposé par le serveur. L’application serveur construit ce vecteur. Une valeur null indique qu’il n’y a pas d’UUID d’objet à exporter (seuls les handles de liaison doivent être exportés).

Valeur retournée

Valeur	Signification
RPC_S_OK	L’appel a réussi.
RPC_S_NOTHING_TO_EXPORT	Il n’y avait rien à exporter.
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.
RPC_S_INVALID_NAME_SYNTAX	La syntaxe de nom n’est pas valide.
RPC_S_UNSUPPORTED_NAME_SYNTAX	La syntaxe de nom n’est pas prise en charge.
RPC_S_INCOMPLETE_NAME	Le nom est incomplet.
RPC_S_NO_NS_PRIVILEGE	Aucun privilège pour l’opération name-service.
RPC_S_NAME_SERVICE_UNAVAILABLE	Nom de service indisponible.

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

Notes

La fonction RpcNsBindingExport permet à une application serveur d’offrir publiquement une interface dans la base de données name-service pour une utilisation par n’importe quelle application cliente.

À compter de Windows 2000, l’environnement d’exécution RPC utilise Active Directory comme base de données name-service. Cela signifie que les entrées exportées autorisées sont conservées dans le service de noms et sont visibles même après le redémarrage. Les exportations non autorisées ne sont pas conservées. Pour plus d’informations sur les listes d’autorisation et de Access Control, consultez Access Control dans la section Sécurité du Kit de développement logiciel (SDK) de plateforme.

Pour exporter une interface, l’application serveur appelle la routine RpcNsBindingExport avec une interface et les handles de liaison de serveur qu’un client peut utiliser pour accéder au serveur. Une application serveur appelle également la fonction RpcNsBindingExport pour proposer publiquement les UUID d’objet de la ou des ressources qu’elle propose, le cas échéant, dans la base de données name-service.

Un serveur peut exporter des interfaces et des objets en un seul appel à RpcNsBindingExport, ou il peut les exporter séparément. Si l’entrée de base de données name-service spécifiée par EntryName n’existe pas, RpcNsBindingExport tente de la créer. Dans ce cas, l’application serveur doit avoir le privilège de créer l’entrée. En plus d’appeler RpcNsBindingExport, un serveur qui a appelé la fonction RpcServerUseAllProtseqs ou RpcServerUseProtseq doit également s’inscrire auprès de la base de données de mappage de point de terminaison locale en appelant RpcEpRegister ou RpcEpRegisterNoReplace.

Un serveur n’est pas tenu d’exporter ses interfaces vers la base de données name-service. Lorsqu’un serveur n’exporte pas, seuls les clients qui connaissent en privé les informations de liaison du serveur peuvent accéder à ses interfaces. Par exemple, un client qui dispose des informations nécessaires à la construction d’une liaison de chaîne peut appeler RpcBindingFromStringBinding pour créer un handle de liaison pour effectuer des appels de procédure distante à un serveur.

Avant d’appeler RpcNsBindingExport, un serveur doit effectuer les opérations suivantes :

Inscrivez une ou plusieurs séquences de protocole auprès de la bibliothèque d’exécution RPC locale en appelant l’une des fonctions suivantes :
Obtenez la liste des liaisons de serveur en appelant la fonction RpcServerInqBindings .

Le vecteur retourné par la fonction RpcServerInqBindings devient le paramètre Binding pour RpcNsBindingExport. Pour empêcher l’exportation d’une liaison, définissez l’élément vectoriel sélectionné sur une valeur null.

Si un serveur exporte plusieurs fois vers la même entrée de base de données nom-service, le deuxième appel et les appels suivants à RpcNsBindingExport ajoutent les informations de liaison et les UUID d’objet lorsque ces données sont différentes des informations de liaison déjà contenues dans l’entrée du serveur. Les données existantes ne sont pas supprimées de l’entrée.

Pour supprimer les descripteurs de liaison et les UUID d’objets de la base de données name-service, une application serveur appelle la fonction RpcNsBindingUnexport .

Une entrée de serveur doit avoir au moins un handle de liaison pour exister. Par conséquent, l’exportation de uniquement des UUID vers une entrée inexistante n’a aucun effet, et l’annulation de l’exportation de tous les handles de liaison supprime l’entrée.

Notes

L’en-tête rpcnsi.h définit RpcNsBindingExport en tant qu’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. La combinaison 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.

Spécifications


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	rpcnsi.h (inclure Rpc.h)
Bibliothèque	Rpcns4.lib
DLL	Rpcns4.dll