RpcMgmtInqServerPrincNameW, fonction (rpcdce.h)

Article
11/20/2024

La fonction RpcMgmtInqServerPrincName retourne le nom principal d’un serveur.

Syntaxe

RPC_STATUS RpcMgmtInqServerPrincNameW(
  RPC_BINDING_HANDLE Binding,
  unsigned long      AuthnSvc,
  RPC_WSTR           *ServerPrincName
);

Paramètres

Binding

Pour recevoir le nom principal d’un serveur, spécifiez un handle de liaison de serveur pour ce serveur. Pour recevoir le nom principal de votre propre application (locale), spécifiez une valeur de NULL.

AuthnSvc

Service d’authentification pour lequel un nom de principal est retourné. Les valeurs valides sont la constante de n’importe quel fournisseur de sécurité valide.

ServerPrincName

Retourne un nom de principal inscrit pour le service d’authentification dans AuthnSvc par le serveur référencé dans liaison. Si plusieurs noms sont inscrits, un seul nom est retourné.

Valeur de retour

Valeur	Signification
RPC_S_OK	L’appel a réussi.
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.

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

Remarques

Une application appelle la fonction RpcMgmtInqServerPrincName pour obtenir le nom principal d’un serveur inscrit pour un service d’authentification spécifié.

La bibliothèque d’exécution RPC alloue de la mémoire pour la chaîne retournée dans ServerPrincName. L’application est chargée d’appeler la fonction RpcStringFree pour libérer la mémoire utilisée par cette fonction.

Le serveur doit écouter les appels de procédure distante pour que cette fonction réussisse. Si le serveur n’écoute pas, la fonction échoue.

Note

L’en-tête rpcdce.h définit RpcMgmtInqServerPrincName 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 \| Applications UWP]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau \| Applications UWP]
plateforme cible	Windows
d’en-tête	rpcdce.h (inclure Rpc.h)
bibliothèque	Rpcrt4.lib
DLL	Rpcrt4.dll

Voir aussi

rpcStringFree

Partager via