RtlIpv6AddressToStringW 函式（ip2string.h）

發行項
11/20/2024

RtlIpv6AddressToString 函式會將 IPv6 位址轉換成因特網標準格式的字串。

語法

NTSYSAPI PWSTR RtlIpv6AddressToStringW(
  [in]  const in6_addr *Addr,
  [out] PWSTR          S
);

參數

[in] Addr

以網路位元組順序排列的IPv6位址。

[out] S

緩衝區的指標，用來儲存 IPv6 位址的 NULL字串表示。此緩衝區應該夠大，足以保存至少 46 個字元。

傳回值

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

言論

RtlIpv6AddressToString 函式可用來將 IPv6 位址轉換成因特網標準格式之 IPv6 位址的字串表示。

基本字串表示是由以冒號分隔的8個十六進位數位所組成。連續零數位的字串會以雙冒號取代。 IPv6 位址的字串表示中只能有一個雙冒號。如果位址是 IPv4 相容位址、IPv4 對應 IPv6 位址或 ISATAP 位址，則最後 32 位會以 IPv4 樣式的 dotted-octet 表示法表示。如需詳細資訊，請參閱 IETF 所發行 RFC 5942 的第 5 節。

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

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

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

IN6_ADDR 結構定義於 In6addr.h 頭檔中。

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

注意

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

要求

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