Fonction RpcBindingSetAuthInfo (rpcdce.h)
La fonction RpcBindingSetAuthInfo définit les informations d’authentification et d’autorisation d’un handle de liaison.
Syntaxe
RPC_STATUS RpcBindingSetAuthInfo(
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 auquel les informations d’authentification et d’autorisation doivent être appliquées.
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é.
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 la liste des constantes de niveau d’authentification.
AuthnSvc
Service d’authentification à utiliser. Consultez Remarque.
Spécifiez RPC_C_AUTHN_NONE pour désactiver l’authentification pour les appels de procédure distante effectués à l’aide de 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 liaison.
AuthIdentity
Gérez la structure contenant 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 .
Lorsque vous sélectionnez le service d’authentification RPC_C_AUTHN_GSS_SCHANNEL, le paramètre AuthIdentity doit être un pointeur vers une structure de SCHANNEL_CRED (définie dans Schannel.h). 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.
AuthzSvc
Service d’autorisation implémenté par le serveur pour l’interface d’intérêt. Consultez Remarque.
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.
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. |
|
Service d’authentification inconnu. |
Notes
Une application cliente appelle la fonction RpcBindingSetAuthInfo pour configurer un handle de liaison de serveur pour effectuer des appels de procédure distante authentifiés. Un client n’est pas obligé d’appeler cette fonction.
Sauf si un client appelle RpcBindingSetAuthInfo, aucun appel de procédure distante sur le handle de liaison de liaison n’est authentifié. Un serveur peut appeler RpcBindingInqAuthClient à partir d’un appel de procédure distante pour déterminer si cet appel a été authentifié.
La fonction RpcBindingSetAuthInfo 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.
En raison des différentes exigences des différentes versions de Microsoft RPC, Microsoft recommande à votre application de conserver un pointeur vers le paramètre AuthIdentity tant que le handle de liaison existe. Cela augmente la portabilité de l’application.
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 la durée de vie du handle de liaison. Ce pointeur doit uniquement être conservé si des appels ultérieurs à RpcBindingInqAuthInfo ou RpcBindingInqAuthInfoEx sont effectués.
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
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour