RpcBindingSetAuthInfoExW, fonction (rpcdce.h)

La fonction RpcBindingSetAuthInfoEx définit les informations d’authentification, d’autorisation et de qualité de service d’un handle de liaison.

Syntaxe

RPC_STATUS RpcBindingSetAuthInfoExW(
  RPC_BINDING_HANDLE       Binding,
  RPC_WSTR                 ServerPrincName,
  unsigned long            AuthnLevel,
  unsigned long            AuthnSvc,
  RPC_AUTH_IDENTITY_HANDLE AuthIdentity,
  unsigned long            AuthzSvc,
  RPC_SECURITY_QOS         *SecurityQOS
);

Paramètres

Binding

Handle de liaison de serveur dans lequel les informations d’authentification et d’autorisation sont définies.

ServerPrincName

Pointeur vers le nom principal attendu du serveur référencé par Binding. Le contenu du nom et sa syntaxe sont définis par le service d’authentification utilisé.

Note Pour l’ensemble des noms de cibles autorisés pour les fournisseurs de services de sécurité, reportez-vous aux commentaires de la documentation InitializeSecurityContext .

 

AuthnLevel

Niveau d’authentification à effectuer sur les appels de procédure distante effectués à l’aide de liaison. Pour obtenir la liste des niveaux d’authentification pris en charge par RPC, consultez Constantes de niveau d’authentification.

AuthnSvc

Service d’authentification à utiliser.

Spécifiez RPC_C_AUTHN_NONE pour désactiver l’authentification pour les appels de procédure distante effectués à l’aide de la liaison.

Si RPC_C_AUTHN_DEFAULT est spécifié, la bibliothèque d’exécution RPC utilise le service d’authentification RPC_C_AUTHN_WINNT pour les appels de procédure distante effectués à l’aide de binding.

AuthIdentity

Handle pour la structure qui contient les informations d’identification d’authentification et d’autorisation du client appropriées pour le service d’authentification et d’autorisation sélectionné.

Lors de l’utilisation du service d’authentification RPC_C_AUTHN_WINNT, AuthIdentity doit être un pointeur vers une structure de SEC_WINNT_AUTH_IDENTITY (définie dans Rpcdce.h). Les services d’authentification Kerberos et Negotiate utilisent également la structure SEC_WINNT_AUTH_IDENTITY .

Spécifiez une valeur Null pour utiliser le contexte de connexion de sécurité pour l’espace d’adressage actuel. Transmettez la valeur RPC_C_NO_CREDENTIALS pour utiliser un contexte de connexion anonyme. Notez que RPC_C_NO_CREDENTIALS est valide uniquement si RPC_C_AUTHN_GSS_SCHANNEL est sélectionné comme service d’authentification.

AuthzSvc

Service d’autorisation implémenté par le serveur pour l’interface d’intérêt. La validité et la fiabilité des données d’autorisation, comme toutes les données d’application, dépendent du service d’authentification et du niveau d’authentification sélectionnés. Ce paramètre est ignoré lors de l’utilisation du service d’authentification RPC_C_AUTHN_WINNT. Consultez Remarque.

SecurityQOS

Pointeur vers la structure RPC_SECURITY_QOS , qui définit la qualité de service de sécurité.

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_S_UNKNOWN_AUTHN_SERVICE	Service d’authentification inconnu.

 

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

 

Remarques

Une application cliente appelle la fonction RpcBindingSetAuthInfoEx pour configurer un handle de liaison de serveur pour effectuer des appels de procédure distante authentifiée. Cette fonction permet de définir des informations sur la qualité de service de sécurité sur le handle de liaison. Sinon, elle est identique à RpcBindingSetAuthInfo.

Sauf si un client appelle RpcBindingSetAuthInfoEx, tous les appels de procédure distante sur Binding ne sont pas authentifiés. Un client n’est pas obligé d’appeler cette fonction.

La fonction RpcBindingSetAuthInfoEx prend une instantané des informations d’identification. Par conséquent, la mémoire dédiée au paramètre AuthIdentity peut être libérée avant le handle de liaison. L’exception à cela est lorsque votre application utilise RpcBindingSetAuthInfoEx avec RPC_C_QOS_IDENTITY_DYNAMIC et spécifie également une valeur non NULL pour AuthIdentity.

Note La fonction RpcBindingSetAuthInfo ne doit pas être appelée sur un handle de liaison pendant qu’un appel RPC sur le même handle est en cours. Cela produit des résultats non définis.

 

En raison des différentes exigences des différentes versions de Microsoft RPC, Microsoft recommande qu’une application conserve un pointeur vers le paramètre AuthIdentity tant que le handle de liaison existe. Cela augmente la portabilité des applications.

Windows Server 2003 avec SP1 et Windows XP avec SP2 : Pour Windows XP SP2 et Windows Server 2003 SP1, le pointeur vers le paramètre AuthIdentity n’a pas besoin d’être conservé pendant toute la durée de vie du handle de liaison. Ce pointeur doit être conservé uniquement si des appels ultérieurs à RpcBindingInqAuthInfo ou RpcBindingInqAuthInfoEx sont effectués.

Note La séquence de protocole ncalrpc prend en charge uniquement RPC_C_AUTHN_WINNT, mais prend en charge l’authentification mutuelle ; fournissez un SPN et demandez l’authentification mutuelle via le paramètre SecurityQOS pour y parvenir.

 

Notes

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

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

Voir aussi

RPC_SECURITY_QOS

RpcBindingInqAuthInfoEx

RpcServerRegisterAuthInfo