NetRenameMachineInDomain-Funktion (lmjoin.h)

Artikel
08/24/2023

Die NetRenameMachineInDomain-Funktion ändert den Namen eines Computers in einer Domäne.

Syntax

NET_API_STATUS NET_API_FUNCTION NetRenameMachineInDomain(
  [in] LPCWSTR lpServer,
  [in] LPCWSTR lpNewMachineName,
  [in] LPCWSTR lpAccount,
  [in] LPCWSTR lpPassword,
  [in] DWORD   fRenameOptions
);

Parameter

[in] lpServer

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

[in] lpNewMachineName

Ein Zeiger auf eine konstante Zeichenfolge, die den neuen Namen des Computers angibt. Wenn angegeben, wird auch der Name des lokalen Computers geändert. Wenn dieser Parameter NULL ist, geht die Funktion davon aus, dass Sie bereits die SetComputerNameEx-Funktion aufgerufen haben.

[in] lpAccount

Ein Zeiger auf eine konstante Zeichenfolge, die einen Kontonamen angibt, der beim Herstellen einer Verbindung mit dem Domänencontroller verwendet werden soll. 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] fRenameOptions

Die Umbenennungsoptionen. Wenn dieser Parameter NETSETUP_ACCT_CREATE ist, benennt die Funktion das Konto in der Domäne um.

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_ACCESS_DENIED	Der Zugriff wird verweigert. Dieser Fehler wird zurückgegeben, wenn der im lpAccount-Parameter übergebene Kontoname nicht über ausreichende Zugriffsrechte für den Vorgang verfügte.
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 Umbenennen eines Domänencomputers kann nur von einem Benutzer durchgeführt werden, der Mitglied der lokalen Gruppe Administratoren auf dem Zielcomputer ist und auch Mitglied der Gruppe Administratoren in der Domäne ist oder über die Berechtigung Kontooperator für die Domäne verfügt. Wenn Sie die NetRenameMachineInDomain-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 NetRenameMachineInDomain-Funktion nicht gleichzeitig aufrufen. Diese Situation kann den Computer in einem inkonsistenten Zustand belassen.

Die NERR_SetupNotJoined - und NERR_SetupDomainController Rückgabewerte sind in der Lmerr.h-Headerdatei definiert. Diese Headerdatei wird automatisch von der Lm.h-Headerdatei eingeschlossen und sollte nicht direkt eingeschlossen werden.

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

Anforderungen


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