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.

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

Voir aussi

DsGetDcName

Obtenir des fonctions

NetGetDCName

Fonctions de gestion réseau

Vue d’ensemble de la gestion du réseau