RpcMgmtInqServerPrincName, fonction (rpcdce.h)
La fonction RpcMgmtInqServerPrincName retourne le nom principal d’un serveur.
Syntaxe
RPC_STATUS RpcMgmtInqServerPrincName(
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 la valeur NULL.
AuthnSvc
Service d’authentification pour lequel un nom principal est retourné. Les valeurs valides sont la constante pour tout 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 Binding. Si plusieurs noms sont inscrits, un seul nom est retourné.
Valeur retournée
| Valeur | Signification |
|---|---|
|
L’appel a réussi. |
|
Le handle de liaison n’était pas valide. |
|
Il s’agissait du mauvais type de liaison pour l’opération. |
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 être à l’écoute des appels de procédure distante pour que cette fonction réussisse. Si le serveur n’écoute pas, la fonction échoue.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau | Applications UWP] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau | Applications UWP] |
| Plateforme cible | Windows |
| En-tête | rpcdce.h (inclure Rpc.h) |
| Bibliothèque | Rpcrt4.lib |
| DLL | Rpcrt4.dll |