共用方式為

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 指定緩衝區的大小。 在輸出中，接收複製到目的地緩衝區的 TCHA 數目 ，不包括終止 Null 字元。

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

傳回值

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

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

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

備註

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

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

注意

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

規格需求

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

另請參閱

GetComputerNameEx

SetComputerNameEx

系統資訊函式