DnsHostnameToComputerNameA 函式（winbase.h）

將 DNS 樣式主機名轉換為 NetBIOS 樣式的電腦名稱。

語法

BOOL DnsHostnameToComputerNameA(
  [in]      LPCSTR  Hostname,
  [out]     LPSTR   ComputerName,
  [in, out] LPDWORD nSize
);

[in] Hostname

DNS 名稱。如果 DNS 名稱不是有效的可轉譯名稱，則函式會失敗。如需詳細資訊，請參閱電腦名稱。

[out] ComputerName

接收電腦名稱之緩衝區的指標。緩衝區大小應該夠大，足以包含MAX_COMPUTERNAME_LENGTH + 1 個字元。

[in, out] nSize

在輸入上，指定緩衝區的大小，TCHAR。在輸出中，接收複製到目的地緩衝區的 T CHAR 數目，不包括終止的 Null 字元。

如果緩衝區太小，函式會失敗，GetLastError 會傳回ERROR_MORE_DATA，nSize 會收到所需的緩衝區大小，不包括終止的 Null 字元。

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

如果函式失敗，傳回值為零。若要取得擴充的錯誤資訊，請呼叫 GetLastError。可能的值包括下列專案。

傳回碼	描述
ERROR_MORE_DATA	ComputerName 緩衝區太小。 nSize 參數包含接收名稱所需的位元元數目。

此函式會執行名稱的文字對應。此慣例會將計算機的名稱限制為名稱的一般子集。（具體而言，DNS 名稱的最左邊標籤會截斷為15位元組的 OEM 字元。因此，請勿使用此函式將 DNS 功能變數名稱轉換成 NetBIOS 功能變數名稱。功能變數名稱沒有文字對應。

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

注意

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

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