DsBindW, fonction (ntdsapi.h)

Article
11/20/2024

La fonction DsBind lie à un contrôleur de domaine. DsBind utilise les informations d’identification de processus par défaut pour établir une liaison au contrôleur de domaine. Pour spécifier d’autres informations d’identification, utilisez la fonction DsBindWithCred.

Syntaxe

NTDSAPI DWORD DsBindW(
  [in, optional] LPCWSTR DomainControllerName,
  [in, optional] LPCWSTR DnsDomainName,
  [out]          HANDLE  *phDS
);

Paramètres

[in, optional] DomainControllerName

Pointeur vers une chaîne terminée par null qui contient le nom du contrôleur de domaine à lier. Ce nom peut être le nom du contrôleur de domaine ou le nom DNS complet du contrôleur de domaine. L’un ou l’autre type de nom peut, éventuellement, être précédé de deux caractères de barre oblique inverse. Tous les exemples suivants représentent les noms de contrôleurs de domaine correctement mis en forme :

« FAB-DC-01 »
« \\FAB-DC-01 »
« FAB-DC-01.fabrikam.com »
« \\FAB-DC-01.fabrikam.com »

Ce paramètre peut être NULL. Pour plus d’informations, consultez Remarques.

[in, optional] DnsDomainName

Pointeur vers une chaîne terminée par null qui contient le nom DNS complet du domaine à lier. Ce paramètre peut être NULL. Pour plus d’informations, consultez Remarques.

[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

Le comportement de la fonction d' DsBind est déterminé par le contenu des paramètres DomainControllerName et DnsDomainName. La liste suivante décrit le comportement de cette fonction en fonction du contenu de ces paramètres.

DomainControllerName	DnsDomainName	Description
NULL	NULL	DsBind tente de lier à un serveur de catalogue global dans la forêt de l’ordinateur local.
(valeur)	NULL	DsBind tente de lier le contrôleur de domaine spécifié par le paramètre DomainControllerName.
NULL	(valeur)	DsBind tente de lier à n’importe quel contrôleur de domaine dans le domaine spécifié par paramètre dnsDomainName.
(valeur )	(valeur)	Le paramètre DomainControllerName est prioritaire. DsBind tente de lier le contrôleur de domaine spécifié par le paramètre DomainControllerName.

Note

L’en-tête ntdsapi.h définit DsBind en tant qu’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

DOMAIN_CONTROLLER_INFO

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

DsBindWithCred

DsGetDcName

DsUnBind

Partager via