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 |