SetComputerNameExA 函式（sysinfoapi.h）

設定本機電腦的新 NetBIOS 或 DNS 名稱。 SetComputerNameEx 所做的名稱變更 在使用者重新啟動電腦之前不會生效。

語法

BOOL SetComputerNameExA(
  [in] COMPUTER_NAME_FORMAT NameType,
  [in] LPCSTR               lpBuffer
);

[in] NameType

要設定的名稱類型。這個參數可以是下列 COMPUTER_NAME_FORMAT 列舉類型的其中一個值。

價值	意義
ComputerNamePhysicalDnsDomain	設定電腦的主要 DNS 後綴。
ComputerNamePhysicalDnsHostname	將 NetBIOS 和電腦名稱（完整 DNS 名稱的第一個標籤）設定為 lpBuffer 中所指定的名稱，。如果名稱超過MAX_COMPUTERNAME_LENGTH個字元，NetBIOS 名稱會截斷為MAX_COMPUTERNAME_LENGTH個字元，不包括終止的 Null 字元。
ComputerNamePhysicalNetBIOS	將 NetBIOS 名稱設定為 lpBuffer中指定的名稱。名稱不能超過MAX_COMPUTERNAME_LENGTH個字元，不包括終止的 Null 字元。警告：使用此選項來設定 NetBIOS 名稱會中斷相依的 NetBIOS 和 DNS 名稱慣例。使用 DnsHostnameToComputerName 函式從 DNS 名稱的第一個標籤衍生 NetBIOS 名稱的應用程式，如果此慣例中斷，將會失敗。

[in] lpBuffer

新名稱。名稱不能包含控制字元、前置或尾端空格，或下列任何字元：“ / \ [ ] ： |<> + = ;, ?

如果函式成功，則傳回值是非零值。

如果函式失敗，傳回值為零。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

SetComputerNameEx 可以設定電腦名稱（完整 DNS 名稱的第一個標籤）或本機電腦的主要 DNS 後綴。它無法在一次呼叫中設定完整 DNS 名稱。

如果本機計算機是叢集中的節點，SetComputerNameEx 設定本機電腦的 NetBIOS 或 DNS 名稱，而不是叢集虛擬伺服器的名稱。

呼叫 SetComputerNameEx 函式的程式必須在本機電腦上具有系統管理員許可權。

若要編譯使用此函式的應用程式，請將_WIN32_WINNT定義為0x0500或更新版本。如需詳細資訊，請參閱使用 Windows 標頭。

注意

sysinfoapi.h 標頭會根據 UNICODE 預處理器常數的定義，將 SetComputerNameEx 定義為自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。

要求	價值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平臺	窗戶
標頭	sysinfoapi.h （包括 Windows.h）
連結庫	Kernel32.lib
DLL	Kernel32.dll