NetUnjoinDomain-Funktion (lmjoin.h)
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 |
|---|---|
|
Ein Parameter ist falsch. |
|
Der Computer ist derzeit nicht mit einer Domäne verbunden. |
|
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 |