inet_ntoa函式 (winsock.h)

發行項
03/13/2024

inet_ntoa函式會將 (Ipv4) 因特網網路位址轉換成以因特網標準虛線十進位格式的 ASCII 字串。

語法

char * inet_ntoa(
  in_addr in
);

參數

in

TBD

傳回值

如果沒有發生錯誤， inet_ntoa 會將字元指標傳回靜態緩衝區，其中包含標準 “.'' 中的文字位址符號。否則會傳回 NULL。

備註

inet_ntoa函式會採用 in 參數所指定的因特網地址結構，並傳回 NULL 終止的 ASCII 字串，代表 “.” (點) 表示法中的位址，如 “192.168.16.0”，這是以 dotted-decimal 表示法表示法表示的 IPv4 位址範例。 inet_ntoa所傳回的字串位於 Windows Sockets 配置的記憶體中。應用程式不應對配置記憶體的方式進行任何假設。只有在相同線程內進行下一個 Windows Sockets 函式呼叫之前，傳回的字串才保證有效。因此，應該先複製數據，再進行另一個 Windows Sockets 呼叫。

WSAAddressToString 函式可用來將包含 IPv4 位址的 sockaddr 結構轉換成因特網標準虛線十進位表示法中 IPv4 位址的字串表示法。 WSAAddressToString 函式的優點是它同時支援 IPv4 和 IPv6 位址。 WSAAddressToString 函式的另一個優點是，此函式同時有 ASCII 和 Unicode 版本。

在 Windows Vista 和更新版本上， RtlIpv4AddressToString 函式可用來將以 IN_ADDR 結構表示的 IPv4 位址轉換為以因特網標準虛線十進位表示法表示法的 IPv4 位址字元串表示法。在 Windows Vista 和更新版本上， RtlIpv6AddressToString 函式可用來將以 IN6_ADDR 結構表示的 IPv6 位址轉換為 IPv6 位址的字串表示。

Windows Phone 8：Windows Phone 8 和更新版本上的 Windows Phone Store 應用程式支援此函式。

Windows 8.1 和 Windows Server 2012 R2：Windows 8.1、Windows Server 2012 R2 及更新版本上的 Windows 市集應用程式支援此函式。

規格需求

需求	值
最低支援的用戶端	Windows 8.1、Windows Vista [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	Windows Server 2003 [傳統型應用程式 \|UWP 應用程式]
目標平台	Windows
標頭	winsock.h (包括 Winsock2.h、Winsock.h)
程式庫	Ws2_32.lib
Dll	Ws2_32.dll