NetUnjoinDomain-Funktion (lmjoin.h)

  • Artikel

Die NetUnjoinDomain-Funktion hebt die Verknüpfung eines Computers aus einer Arbeitsgruppe oder Domäne auf.

Syntax

NET_API_STATUS NET_API_FUNCTION NetUnjoinDomain(
  [in] LPCWSTR lpServer,
  [in] LPCWSTR lpAccount,
  [in] LPCWSTR lpPassword,
  [in] DWORD   fUnjoinOptions
);

Parameter

[in] lpServer

Ein Zeiger auf eine konstante Zeichenfolge, die den DNS- oder NetBIOS-Namen des Computers angibt, auf dem die Funktion ausgeführt werden soll. Wenn dieser Parameter NULL ist, wird der lokale Computer verwendet.

[in] lpAccount

Ein Zeiger auf eine konstante Zeichenfolge, die den Kontonamen angibt, der beim Herstellen einer Verbindung mit dem Domänencontroller verwendet werden soll. Die Zeichenfolge muss entweder einen NetBIOS-Domänennamen und ein Benutzerkonto (z. B. REDMOND\user) oder den Benutzerprinzipalnamen (UPN) des Benutzers in Form eines Anmeldenamens im Internetformat (z. B. "someone@example.com") angeben. Wenn dieser Parameter NULL ist, wird der Kontext des Aufrufers verwendet.

[in] lpPassword

Wenn der parameter lpAccount einen Kontonamen angibt, muss dieser Parameter auf das Kennwort verweisen, das beim Herstellen einer Verbindung mit dem Domänencontroller verwendet werden soll. Andernfalls muss dieser Parameter NULL sein.

[in] fUnjoinOptions

Gibt die Optionen für das Aufheben der Verknüpfung an. Wenn dieser Parameter NETSETUP_ACCT_DELETE ist, wird das Konto deaktiviert, wenn die Verknüpfung aufheben. Beachten Sie, dass diese Option das Konto nicht löscht. Derzeit sind keine anderen Optionen für die Verknüpfung definiert.

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 oder einer der Systemfehlercodes sein.

Rückgabecode Beschreibung
ERROR_INVALID_PARAMETER
 Ein Parameter ist falsch.
NERR_SetupNotJoined
 Der Computer ist derzeit nicht mit einer Domäne verbunden.
NERR_SetupDomainController
 Dieser Computer ist ein Domänencontroller und kann nicht von einer Domäne getrennt werden.

Hinweise

Das Aufheben der Verknüpfung (und Der Beitritt) eines Computers zu einer Domäne oder Arbeitsgruppe kann nur von einem Mitglied der lokalen Gruppe Administratoren auf dem Zielcomputer ausgeführt werden. Wenn Sie die NetUnjoinDomain-Funktion remote aufrufen, müssen Sie Anmeldeinformationen angeben, da Sie anmeldeinformationen unter diesen Umständen nicht delegieren können.

Verschiedene Prozesse oder unterschiedliche Threads desselben Prozesses sollten die NetUnjoinDomain-Funktion nicht gleichzeitig aufrufen. Diese Situation kann den Computer in einem inkonsistenten Zustand belassen.

Nach dem Aufrufen der NetRenameMachineInDomain-Funktion ist ein Systemneustart erforderlich, damit der Vorgang abgeschlossen werden kann.

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 lmjoin.h (lm.h einschließen)
Bibliothek Netapi32.lib
DLL Netapi32.dll

Weitere Informationen

NetJoinDomain

NetRenameMachineInDomain

Netzwerkverwaltungsfunktionen

Übersicht über die Netzwerkverwaltung