RtlIpv4AddressToStringA 函式（ip2string.h）

發行項
11/20/2024

RtlIpv4AddressToString 函式會將 IPv4 位址轉換成因特網標準 dotted-decimal 格式的字串。

語法

NTSYSAPI PSTR RtlIpv4AddressToStringA(
  [in]  const in_addr *Addr,
  [out] PSTR          S
);

參數

[in] Addr

網路位元組順序中的IPv4位址。

[out] S

緩衝區的指標，用來儲存 NULLIPv4 位址的終止字串表示。此緩衝區的大小應該足以容納至少 16 個字元。

傳回值

插入 IPv4 位址字串表示之字串結尾之 NULL 字元的指標。呼叫端可以使用此選項，輕鬆地將更多資訊附加至字串。

言論

RtlIpv4AddressToString 函式會用來將 IPv4 位址轉換成以因特網點十進位格式表示 IPv4 位址的字串表示。

RtlIpv4AddressToString 是一種便利函式，不需要載入 Windows Sockets DLL 以存取 Windows Sockets 中提供的函式，以執行 IP 位址到字符串轉換。

定義 UNICODE 或_UNICODE時，RtlIpv4AddressToString 定義為 RtlIpv4AddressToStringW，此函式的 Unicode 版本。字串參數 S，且函式傳回值會定義至 PWSTR 數據類型。

未定義 UNICODE 和_UNICODE時，RtlIpv4AddressToString 定義為 RtlIpv4AddressToStringA，此函式的 ANSI 版本。字串參數 S，且函式傳回值會定義至 PSTR 數據類型。

IN_ADDR 結構定義於 Inaddr.h 頭檔中。

包含 RtlIpv4AddressToString 函式的匯入連結庫不包含在 Windows Vista 發行的 Microsoft Windows 軟體開發工具包（SDK）中。 RtlIpv4AddressToString 函式包含在 Windows 驅動程式套件（WDK）隨附的 Ntdll.lib 匯入連結庫中。應用程式也可以使用 GetModuleHandle 和 GetProcAddress 函式，從 Ntdll.dll 擷取函式指標並呼叫此函式。

注意

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

要求

要求	價值
最低支援的用戶端	Windows Vista [傳統型應用程式 \|UWP 應用程式]
支援的最低伺服器	Windows Server 2008 [傳統型應用程式 \|UWP 應用程式]
目標平臺	窗戶
標頭	ip2string.h （include Mstcpip.h， Ip2string.h）
連結庫	ntdll.lib
DLL	ntdll.dll