Fonction RpcBindingInqAuthInfo (rpcdce.h)

Article
08/25/2023

La fonction RpcBindingInqAuthInfo retourne des informations d’authentification et d’autorisation à partir d’un handle de liaison.

Syntaxe

RPC_STATUS RpcBindingInqAuthInfo(
  RPC_BINDING_HANDLE       Binding,
  RPC_CSTR                 *ServerPrincName,
  unsigned long            *AuthnLevel,
  unsigned long            *AuthnSvc,
  RPC_AUTH_IDENTITY_HANDLE *AuthIdentity,
  unsigned long            *AuthzSvc
);

Paramètres

Binding

Handle de liaison de serveur à partir duquel les informations d’authentification et d’autorisation sont retournées.

ServerPrincName

Retourne un pointeur vers un pointeur vers le nom principal attendu du serveur référencé dans Liaison. Le contenu du nom retourné et sa syntaxe sont définis par le service d’authentification utilisé.

Spécifiez une valeur null pour empêcher RpcBindingInqAuthInfo de renvoyer le paramètre ServerPrincName . Dans ce cas, l’application n’appelle pas la fonction RpcStringFree .

AuthnLevel

Retourne un jeu de pointeurs au niveau d’authentification utilisé pour les appels de procédure distante effectués à l’aide de liaison. Consultez Remarque.

Spécifiez une valeur null pour empêcher la fonction de renvoyer le paramètre AuthnLevel .

Le niveau retourné dans le paramètre AuthnLevel peut être différent du niveau spécifié lorsque le client a appelé la fonction RpcBindingSetAuthInfo . Cette différence se produit lorsque la bibliothèque d’exécution RPC ne prend pas en charge le niveau d’authentification spécifié par le client et effectue automatiquement une mise à niveau vers le niveau d’authentification supérieur suivant.

AuthnSvc

Retourne un jeu de pointeurs vers le service d’authentification spécifié pour les appels de procédure distante effectués à l’aide de liaison. Consultez Remarque.

Spécifiez une valeur null pour empêcher RpcBindingInqAuthInfo de renvoyer le paramètre AuthnSvc .

AuthIdentity

Retourne un pointeur vers un handle vers la structure de données qui contient les informations d’identification d’authentification et d’autorisation du client spécifiées pour les appels de procédure distante effectués à l’aide de Liaison.

Spécifiez une valeur null pour empêcher RpcBindingInqAuthInfo de renvoyer le paramètre AuthIdentity .

AuthzSvc

Retourne un jeu de pointeurs vers le service d’autorisation demandé par l’application cliente qui a effectué l’appel de la procédure distante sur liaison Voir note.

Spécifiez une valeur null pour empêcher RpcBindingInqAuthInfo de renvoyer le paramètre AuthzSvc .

Note Pour obtenir la liste des services d’authentification pris en charge par RPC, consultez Constantes de service d’authentification.

Valeur retournée

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.
RPC_BINDING_HAS_NO_AUTH	La liaison n’a aucune information d’authentification.

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

Notes

Une application cliente appelle la fonction RpcBindingInqAuthInfo pour afficher les informations d’authentification et d’autorisation associées à un handle de liaison de serveur. Une fonction similaire, RpcBindingInqAuthInfoEx fournit également des informations de qualité de service de sécurité sur le handle de liaison.

La bibliothèque d’exécution RPC alloue de la mémoire pour le paramètre ServerPrincName retourné. L’application est chargée d’appeler la fonction RpcStringFree pour cette chaîne d’argument retournée.

Spécifications


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