WSANtohl

WSANtohl 関数は u_long をネットワークバイトオーダーからホストバイトオーダーに変換する。

WSANtohl s, netlong, lphostlong

s : [int] ソケットを識別する記述子。
netlong : [int] ネットワークバイトオーダーの 32 ビット数値。
lphostlong : [var] ホストバイトオーダーの数値を受け取る 32 ビット数値へのポインタ。

(プラグイン / モジュール : ws2_32.dll)

解説

WSANtohl 関数は u_long をネットワークバイトオーダーからホストバイトオーダーに変換する。

[戻り値]
エラーがない場合、WSANtohl はゼロを返す。そうでない場合は SOCKET_ERROR が返され、WSAGetLastError
を呼び出すことで特定のエラーコードを取得できる。
このドキュメントは省略されている。

[備考]
WSANtohl 関数は、ネットワークバイトオーダーの 32 ビット数値を受け取り、lphostlong が指す 32
ビット数値にホストバイトオーダーの 32 ビット数値を返す。s 引数に渡したソケットは、ソケットに関連付けられた Winsock
カタログのプロトコルエントリに基づいて必要なネットワークバイトオーダーを決めるために使われる。この機能は異なるネットワークバイトオーダーを使う
Winsock プロバイダをサポートするためである。ソケットが AF_INET または AF_INET6
アドレスファミリのものであれば、WSANtohl はネットワークバイトオーダーの IPv4
アドレスをホストバイトオーダーに変換するために使える。この関数は netlong が有効な IPv4
アドレスかのチェックは行わない。WSANtohl を使うには、事前に WSAStartup の成功呼び出しで Winsock DLL
がロードされていなければならない。AF_INET または AF_INET6 ファミリに対して ntohl 関数を使う場合は、Winsock
DLL のロードは不要である。Windows Phone 8: この関数は Windows Phone 8 以降の Windows
Phone ストアアプリでサポートされる。Windows 8.1 および Windows Server 2012 R2: この関数は
Windows 8.1、Windows Server 2012 R2 以降の Windows ストアアプリでサポートされる。

情報