getComputerNameA 函式 (winbase.h)

擷取本機電腦的 NetBIOS 名稱。當系統從登錄讀取此名稱時，會在系統啟動時建立此名稱。

GetComputerName 只會擷取本機電腦的 NetBIOS 名稱。若要擷取 DNS 主機名稱、DNS 功能變數名稱或完整 DNS 名稱，請呼叫 GetComputerNameEx 函式。 IADsADSystemInfo介面會提供其他資訊。

如果本機電腦是叢集中的節點，此函式的行為可能會受到影響。如需詳細資訊，請參閱 ResUtilGetEnvironmentWithNetName 和 UseNetworkName。

語法

BOOL GetComputerNameA(
  [out]     LPSTR   lpBuffer,
  [in, out] LPDWORD nSize
);

[out] lpBuffer

接收電腦名稱稱或叢集虛擬伺服器名稱之緩衝區的指標。緩衝區大小應該夠大，足以包含MAX_COMPUTERNAME_LENGTH + 1 個字元。

[in, out] nSize

在輸入時，以 TCHAR指定緩衝區的大小。輸出時，複製到目的地緩衝區的 TCHAR 數目，不包括終止的 Null 字元。

如果緩衝區太小，函式會失敗，而且 GetLastError 會傳回ERROR_BUFFER_OVERFLOW。 lpnSize參數會指定所需的緩衝區大小，包括終止的 Null 字元。

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

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

GetComputerName函式會擷取在系統啟動時建立的 NetBIOS 名稱。在使用者重新開機電腦之前， SetComputerName 或 SetComputerNameEx 函式所做的名稱變更不會生效。

如果呼叫端在用戶端會話下執行，此函式會傳回伺服器名稱。若要擷取用戶端名稱，請使用 WTSQuerySessionInformation 函式。

如需範例，請參閱取得系統資訊。

注意

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


最低支援的用戶端	Windows 2000 專業版 [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	Windows 2000 Server [傳統型應用程式 \|UWP 應用程式]
目標平台	Windows
標頭	winbase.h (包含 Windows.h)
程式庫	Kernel32.lib
DLL	Kernel32.dll