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 |
|---|---|
|
Aucun contrôleur de domaine n’a pu être trouvé. |
|
Le domaine spécifié n’est pas un domaine approuvé. |
|
Le côté client de la relation d’approbation est rompu. |
|
Le côté serveur de la relation d’approbation est rompu ou le mot de passe est rompu. |
|
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 |