NetGetAnyDCName-Funktion (lmaccess.h)

Die NetGetAnyDCName-Funktion gibt den Namen eines beliebigen Domänencontrollers (DC) für eine Domäne zurück, der vom angegebenen Server direkt vertraut wird.

Anwendungen, die DNS-Namen unterstützen, sollten die DsGetDcName-Funktion aufrufen. Diese Funktion kann einen beliebigen DC in einer beliebigen Domäne finden, unabhängig davon, ob die Domäne vom angegebenen Server direkt als vertrauenswürdig eingestuft wird oder nicht.

Syntax

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

Parameter

ServerName

Zeiger auf eine konstante Zeichenfolge, die den DNS- oder NetBIOS-Namen des Remoteservers angibt, auf dem die Funktion ausgeführt werden soll. Wenn dieser Parameter NULL ist, wird der lokale Computer verwendet. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

DomainName

Zeiger auf eine konstante Zeichenfolge, die den Namen der Domäne angibt. Wenn dieser Parameter NULL ist, wird der Name des Domänencontrollers für die primäre Domäne verwendet. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

Buffer

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert NERR_Success.

Wenn die Funktion fehlschlägt, kann der Rückgabewert einer der folgenden Fehlercodes sein.

Rückgabecode	Beschreibung
ERROR_NO_LOGON_SERVERS	Es konnten keine Domänencontroller gefunden werden.
ERROR_NO_SUCH_DOMAIN	Die angegebene Domäne ist keine vertrauenswürdige Domäne.
ERROR_NO_TRUST_LSA_SECRET	Die Clientseite der Vertrauensstellung ist unterbrochen.
ERROR_NO_TRUST_SAM_ACCOUNT	Die Serverseite der Vertrauensstellung ist unterbrochen, oder das Kennwort ist beschädigt.
ERROR_DOMAIN_TRUST_INCONSISTENT	Der Server, der geantwortet hat, ist kein ordnungsgemäßer Domänencontroller der angegebenen Domäne.

Hinweise

Es ist keine spezielle Gruppenmitgliedschaft erforderlich, um die NetGetAnyDCName-Funktion erfolgreich auszuführen.

Wenn servername eine eigenständige Arbeitsstation oder einen eigenständigen Server angibt, ist kein Domänenname gültig.

Wenn servername eine Arbeitsstation angibt, die Mitglied einer Domäne ist, oder ein Server, der Mitglied einer Domäne ist, muss sich der Domänenname in derselben Domäne wie servername befinden.

Wenn servername einen Domänencontroller angibt, muss der Domänenname eine der Domänen sein, die von der Domäne vertrauenswürdig sind, für die der Server ein Controller ist. Der Domänencontroller, den dieser Aufruf findet, war während dieses Aufrufs mindestens einmal betriebsbereit.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	lmaccess.h (lm.h einschließen)
Bibliothek	Netapi32.lib
DLL	Netapi32.dll

Weitere Informationen

Dsgetdcname

Abrufen von Funktionen

NetGetDCName

Netzwerkverwaltungsfunktionen

Übersicht über die Netzwerkverwaltung