NetRenameMachineInDomain 函式 (lmjoin.h)

發行項
08/24/2023

NetRenameMachineInDomain函式會變更網域中電腦的名稱。

語法

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

參數

[in] lpServer

常數位符串的指標，指定要呼叫函式之電腦的 DNS 或 NetBIOS 名稱。如果此參數為 Null，則會使用本機電腦。

[in] lpNewMachineName

指定電腦新名稱之常數位符串的指標。如果指定，也會變更本機電腦名稱稱。如果此參數為 Null，函式會假設您已經呼叫 SetComputerNameEx 函式。

[in] lpAccount

常數位符串的指標，指定連接到網域控制站時要使用的帳戶名稱。如果此參數為 Null，則會使用呼叫端的內容。

[in] lpPassword

如果 lpAccount 參數指定帳戶名稱，此參數必須指向連接到網域控制站時要使用的密碼。否則，此參數必須是 Null。

[in] fRenameOptions

重新命名選項。如果此參數NETSETUP_ACCT_CREATE，函式會重新命名網域中的帳戶。

傳回值

如果函式成功，傳回值會NERR_Success。

如果函式失敗，傳回值可以是下列其中一個錯誤碼或其中一個系統錯誤碼。

傳回碼	描述
ERROR_ACCESS_DENIED	存取遭到拒絕。如果傳入 lpAccount 參數的帳戶名稱沒有足夠的存取權限，就會傳回此錯誤。
ERROR_INVALID_PARAMETER	參數不正確。
NERR_SetupNotJoined	電腦目前未加入網域。
NERR_SetupDomainController	這部電腦是網域控制站，無法從網域取消加入。

備註

重新命名網域電腦只能由屬於目的電腦上的 Administrators 本機群組成員的使用者執行，也是網域上 Administrators 群組的成員，或具有網域的帳戶操作員許可權。如果您從遠端呼叫 NetRenameMachineInDomain 函式，您必須提供認證，因為在這些情況下無法委派認證。

不同進程或相同進程的不同執行緒不應該同時呼叫 NetRenameMachineInDomain 函式。這種情況可能會讓電腦處於不一致的狀態。

NERR_SetupNotJoined和NERR_SetupDomainController傳回值定義在 Lmerr.h 標頭檔中。 Lm.h 標頭檔會自動包含此標頭檔，不應直接包含此標頭檔。

呼叫 NetRenameMachineInDomain 函式以完成作業之後，需要系統重新開機。

需求


最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	lmjoin.h (包含 Lm.h)
程式庫	Netapi32.lib
Dll	Netapi32.dll