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 |
|---|---|
|
Es konnten keine Domänencontroller gefunden werden. |
|
Die angegebene Domäne ist keine vertrauenswürdige Domäne. |
|
Die Clientseite der Vertrauensstellung ist unterbrochen. |
|
Die Serverseite der Vertrauensstellung ist unterbrochen, oder das Kennwort ist beschädigt. |
|
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 |