NetGetAnyDCName, fonction (lmaccess.h)

La fonction NetGetAnyDCName retourne le nom d’un contrôleur de domaine (DC) pour un domaine qui est directement approuvé par le serveur spécifié.

Les applications qui prennent en charge les noms de style DNS doivent appeler la fonction DsGetDcName . Cette fonction peut localiser n’importe quel contrôleur de domaine dans n’importe quel domaine, que le domaine soit ou non directement approuvé par le serveur spécifié.

Syntaxe

NET_API_STATUS NET_API_FUNCTION NetGetAnyDCName(
        LPCWSTR ServerName,
        LPCWSTR DomainName,
        LPBYTE  *Buffer
);

Paramètres

ServerName

Pointeur vers une chaîne constante qui spécifie le nom DNS ou NetBIOS du serveur distant sur lequel la fonction doit s’exécuter. Si ce paramètre a la valeur NULL, l’ordinateur local est utilisé. Pour plus d'informations, consultez la section Notes qui suit.

DomainName

Pointeur vers une chaîne constante qui spécifie le nom du domaine. Si ce paramètre a la valeur NULL, le nom du contrôleur de domaine pour le domaine principal est utilisé. Pour plus d'informations, consultez la section Notes qui suit.

Buffer

Valeur retournée

Si la fonction réussit, la valeur de retour est NERR_Success.

Si la fonction échoue, la valeur de retour peut être l’un des codes d’erreur suivants.

Code de retour	Description
ERROR_NO_LOGON_SERVERS	Aucun contrôleur de domaine n’a pu être trouvé.
ERROR_NO_SUCH_DOMAIN	Le domaine spécifié n’est pas un domaine approuvé.
ERROR_NO_TRUST_LSA_SECRET	Le côté client de la relation d’approbation est rompu.
ERROR_NO_TRUST_SAM_ACCOUNT	Le côté serveur de la relation d’approbation est rompu ou le mot de passe est rompu.
ERROR_DOMAIN_TRUST_INCONSISTENT	Le serveur qui a répondu n’est pas un contrôleur de domaine approprié du domaine spécifié.

Remarques

Aucune appartenance à un groupe spécial n’est requise pour exécuter correctement la fonction NetGetAnyDCName .

Si servername spécifie une station de travail autonome ou un serveur autonome, aucun nom de domaine n’est valide.

Si servername spécifie une station de travail qui est membre d’un domaine ou un serveur qui est membre d’un domaine, le nom de domaine doit se trouver dans le même domaine que servername.

Si servername spécifie un contrôleur de domaine, le nom de domaine doit être l’un des domaines approuvés par le domaine pour lequel le serveur est un contrôleur. Le contrôleur de domaine trouvé par cet appel a été opérationnel au moins une fois pendant cet appel.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	lmaccess.h (include Lm.h)
Bibliothèque	Netapi32.lib
DLL	Netapi32.dll

Voir aussi

DsGetDcName

Obtenir des fonctions

NetGetDCName

Fonctions de gestion réseau

Vue d’ensemble de la gestion du réseau