RtlIpv4AddressToStringA 函式 (ip2string.h)
RtlIpv4AddressToString 函式會將 IPv4 位址轉換成以因特網標準虛點十進位格式的字串。
語法
NTSYSAPI PSTR RtlIpv4AddressToStringA(
[in] const in_addr *Addr,
[out] PSTR S
);
參數
[in] Addr
以網路位元組順序排列的IPv4位址。
[out] S
緩衝區的指標,用來儲存 IPv4 位址的 NULL 終止字串表示。 此緩衝區的大小應該足以保存至少 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 應用程式] |
目標平台 | Windows |
標頭 | ip2string.h (包括 Mstcpip.h、Ip2string.h) |
程式庫 | ntdll.lib |
Dll | ntdll.dll |