NetRenameMachineInDomain-Funktion (lmjoin.h)
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 |
|---|---|
|
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. |
|
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 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 |
Weitere Informationen
NetRemoveAlternateComputerName