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 應用程式]
目標平臺	窗戶
標頭	winbase.h （包括 Windows.h）
連結庫	Kernel32.lib
DLL	Kernel32.dll