DsBindWithSpnW, fonction (ntdsapi.h)

Article
11/20/2024

La fonction DsBindWithSpn lie à un contrôleur de domaine à l’aide des informations d’identification spécifiées et d’un nom de principal de service spécifique (SPN) pour l’authentification mutuelle.

Cette fonction est fournie pour l’endroit où le contrôle complet est requis pour l’authentification mutuelle. N’utilisez pas cette fonction si vous attendez DsBind pour trouver un serveur, car les spN sont spécifiques à l’ordinateur, et il est peu probable que le SPN que vous fournissez corresponde au serveur qui DsBind trouve pour vous. La fourniture d’un argument NULLServicePrincipalName entraîne un comportement identique à DsBindWithCred.

Syntaxe

NTDSAPI DWORD DsBindWithSpnW(
  [in, optional] LPCWSTR                  DomainControllerName,
  [in, optional] LPCWSTR                  DnsDomainName,
  [in, optional] RPC_AUTH_IDENTITY_HANDLE AuthIdentity,
  [in, optional] LPCWSTR                  ServicePrincipalName,
  [out]          HANDLE                   *phDS
);

Paramètres

[in, optional] DomainControllerName

Pointeur vers une chaîne terminée par null qui contient le nom DNS complet du domaine à lier. Pour plus d’informations, consultez la description DomainControllerName dans la rubrique DsBind.

[in, optional] DnsDomainName

Pointeur vers une chaîne terminée par null qui contient le nom DNS complet du domaine à lier. Pour plus d’informations, consultez la description DnsDomainName dans la rubrique DsBind.

[in, optional] AuthIdentity

Contient une valeur RPC_AUTH_IDENTITY_HANDLE qui représente les informations d’identification à utiliser pour la liaison. Le

fonction DsMakePasswordCredentials est utilisée pour obtenir cette valeur. Si ce paramètre est NULL, les informations d’identification du thread appelant sont utilisées.

DsUnBind doit être appelée avant de libérer ce handle avec la fonction DsFreePasswordCredentials.

[in, optional] ServicePrincipalName

Pointeur vers une chaîne terminée par null qui spécifie le nom du principal de service à affecter au client. Le passage NULL dans ServicePrincipalName équivaut à un appel à la fonction DsBindWithCred.

[out] phDS

Adresse d’une HANDLE valeur qui reçoit le handle de liaison. Pour fermer ce handle, passez-le à la fonction DsUnBind.

Valeur de retour

Retourne ERROR_SUCCESS en cas de réussite ou d’un code d’erreur Windows ou RPC dans le cas contraire. Voici les codes d’erreur les plus courants.

Remarques

Note

L’en-tête ntdsapi.h définit DsBindWithSpn 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. Le mélange 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Vista
serveur minimum pris en charge	Windows Server 2008
plateforme cible	Windows
d’en-tête	ntdsapi.h
bibliothèque	Ntdsapi.lib
DLL	Ntdsapi.dll

Voir aussi

fonctions de gestion du contrôleur de domaine et de la réplication

DsBind

DsBindWithCred

DsUnBind

Partager via