WSAHtonl

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

WSAHtonl s, hostlong, lpnetlong

s : [int] ソケットを識別するディスクリプタ。
hostlong : [int] ホストバイトオーダーの 32 ビット数値。
lpnetlong : [var] ネットワークバイトオーダーの数値を受け取る 32 ビット数値へのポインタ。

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

解説

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

[戻り値]
エラーがない場合、WSAHtonl はゼロを返す。そうでない場合は SOCKET_ERROR を返し、WSAGetLastError
を呼び出すことで特定のエラーコードを取得できる。
（以下省略）

[備考]
WSAHtonl 関数は、ホストバイトオーダーの 32 ビット数値を受け取り、ネットワークバイトオーダーの 32 ビット数値を
lpnetlong パラメータが指す 32 ビット数値に返す。s パラメータで渡されたソケットは、当該ソケットに関連付けられた
Winsock
カタログのプロトコルエントリに基づいて必要なネットワークバイトオーダーを決定するために使われる。この機能は、異なるネットワークバイトオーダーを使う
Winsock プロバイダをサポートする。ソケットが AF_INET または AF_INET6 アドレスファミリ用の場合、WSAHtonl
関数はホストバイトオーダーの IPv4 アドレスをネットワークバイトオーダーの IPv4 アドレスに変換するために使える。この関数は
hostlong パラメータが有効な IPv4 アドレスかどうかの検査は行わない。WSAHtonl 関数は、事前に WSAStartup
関数の呼び出しが成功して Winsock DLL がロードされていることを必要とする。AF_INET または AF_INET6
ファミリで使う場合、htonl 関数は 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 ストアアプリでサポートされる。

情報