NetAddAlternateComputerName 函式 (lmjoin.h)

發行項
08/24/2023

NetAddAlternateComputerName函式會新增指定電腦的替代名稱。

語法

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

參數

[in, optional] Server

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

[in] AlternateName

常數位符串的指標，指定要加入的替代名稱。此名稱的格式必須是完整 DNS 名稱。

[in, optional] DomainAccount

常數位符串的指標，指定要用來存取 Active Directory 中 Server 參數中所指定電腦的電腦帳戶物件網域帳戶。如果此參數為 Null，則會使用執行此常式的使用者認證。

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

[in, optional] DomainAccountPassword

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

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

[in] Reserved

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

傳回值

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

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

傳回碼	描述
ERROR_ACCESS_DENIED	存取遭到拒絕。如果呼叫端不是目的電腦上的 Administrators 本機群組成員，就會傳回此錯誤。
ERROR_INVALID_NAME	name 參數不正確。如果 AlternateName 參數不包含有效的名稱，就會傳回此錯誤。
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 和更新版本支援 NetAddAlternateComputerName 函式。

NetAddAlternateComputerName函式可用來設定電腦的次要網路名稱。主要名稱是用於驗證的名稱，並對應至電腦帳戶名稱。

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

需求


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