NetSetPrimaryComputerName 函式 (lmjoin.h)

發行項
02/28/2024

NetSetPrimaryComputerName 函式會設定指定電腦的主要計算機名稱。

語法

NET_API_STATUS NET_API_FUNCTION NetSetPrimaryComputerName(
  [in, optional] LPCWSTR Server,
  [in]           LPCWSTR PrimaryName,
  [in, optional] LPCWSTR DomainAccount,
  [in, optional] LPCWSTR DomainAccountPassword,
  [in]           ULONG   Reserved
);

參數

[in, optional] Server

常數位符串的指標，指定要在其中執行此函式的計算機名稱。如果此參數為 NULL，則會使用本機電腦。

[in] PrimaryName

常數位符串的指標，指定要設定的主要名稱。此名稱的格式必須是完整 DNS 名稱。

[in, optional] DomainAccount

常數位符串的指標，指定要用於存取 Active Directory 中 伺服器 參數中所指定電腦的電腦帳戶物件。如果此參數為 NULL，則會使用執行此例程之用戶的認證。

如果伺服器執行此函式未加入網域，則不會使用此參數。

[in, optional] DomainAccountPassword

常數位符串的指標，指定與 DomainAccount 參數中傳遞之網域帳戶相符的密碼。如果此參數為 NULL，則會使用執行此例程之用戶的認證。

如果 DomainAccount 參數為 NULL，則會忽略此參數。如果伺服器執行此函式未加入網域，則不會使用此參數。

[in] Reserved

保留供未來使用。此參數應該是 NULL。

傳回值

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

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

傳回碼	Description
ERROR_ACCESS_DENIED	存取遭到拒絕。如果呼叫端不是目標電腦上的 Administrators 本地組成員，就會傳回此錯誤。
ERROR_INVALID_NAME	名稱參數不正確。如果 PrimaryName 參數不包含有效的名稱，就會傳回此錯誤。
ERROR_INVALID_PARAMETER	參數不正確。如果 DomainAccount 參數不包含有效的網域，就會傳回此錯誤。如果 DomainAccount 參數不是 NULL ，而且 DomainAccountPassword 參數不是 NULL ，但不包含 Unicode 字串，也會傳回此錯誤。
ERROR_NOT_ENOUGH_MEMORY	沒有足夠的記憶體可用來處理此命令。
ERROR_NOT_SUPPORTED	不支援此要求。如果此函式執行所在的 Server 參數中指定的目標電腦是在 Windows 2000 和更早版本上執行，就會傳回此錯誤。
NERR_WkstaNotStarted	工作站服務尚未啟動。
RPC_S_CALL_IN_PROGRESS	此線程已經在進行遠端過程調用。
RPC_S_PROTSEQ_NOT_SUPPORTED	不支援遠端過程調用通訊協定序列。

備註

Windows XP 和更新版本支援 NetSetPrimaryComputerName 函式。

NetSetPrimaryComputerName 函式是做為計算機重新命名作業的一部分。指定的名稱將會從針對目標計算機設定的替代名稱清單中移除，並設定為主要名稱。計算機帳戶名稱將會變更，以符合主要名稱。先前的主要計算機名稱會移至為計算機設定的替代計算機名稱清單。

NetSetPrimaryComputerName 函式要求呼叫端是目標電腦上的 Administrators 本機群組成員。

規格需求

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