RpcBindingInqAuthInfoExA, fonction (rpcdce.h)

  • Article

La fonction RpcBindingInqAuthInfoEx retourne des informations d’authentification, d’autorisation et de qualité de service de sécurité à partir d’un handle de liaison.

Syntaxe

RPC_STATUS RpcBindingInqAuthInfoExA(
  RPC_BINDING_HANDLE       Binding,
  RPC_CSTR                 *ServerPrincName,
  unsigned long            *AuthnLevel,
  unsigned long            *AuthnSvc,
  RPC_AUTH_IDENTITY_HANDLE *AuthIdentity,
  unsigned long            *AuthzSvc,
  unsigned long            RpcQosVersion,
  RPC_SECURITY_QOS         *SecurityQOS
);

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 de principal attendu du serveur référencé dans Binding. 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 RpcBindingInqAuthInfoEx de retourner 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 binding. Pour obtenir la liste des niveaux d’authentification pris en charge par RPC, consultez Constantes de niveau d’authentification. Spécifiez une valeur Null pour empêcher la fonction de retourner 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 RpcBindingSetAuthInfoEx . 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 passe automatiquement au 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 binding. Pour obtenir la liste des services d’authentification pris en charge par RPC, consultez Constantes de service d’authentification.

Spécifiez une valeur null pour empêcher RpcBindingInqAuthInfoEx de retourner 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 binding.

Spécifiez une valeur null pour empêcher RpcBindingInqAuthInfoEx de retourner 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 procédure distante sur Binding. Pour obtenir la liste des services d’authentification pris en charge par RPC, consultez Constantes de service d’authentification.

Spécifiez une valeur Null pour empêcher RpcBindingInqAuthInfoEx de retourner le paramètre AuthzSvc .

RpcQosVersion

Transmet la valeur de la version actuelle (nécessaire pour la compatibilité ascendante si des extensions sont apportées à cette fonction). Définissez toujours ce paramètre sur RPC_C_SECURITY_QOS_VERSION.

SecurityQOS

Retourne un pointeur vers la structure RPC_SECURITY_QOS , qui définit les paramètres de qualité de service.

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 RpcBindingInqAuthInfoEx pour afficher les informations d’authentification et d’autorisation associées à un handle de liaison de serveur. Cette fonction permet de se renseigner sur la qualité de sécurité du service sur le handle de liaison. Sinon, il est identique à RpcBindingInqAuthInfo.

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.

Notes

L’en-tête rpcdce.h définit RpcBindingInqAuthInfoEx 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. 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 | 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

Voir aussi

RPC_SECURITY_QOS

RpcBindingSetAuthInfoEx

RpcStringFree