WSAHtons

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

WSAHtons s, hostshort, lpnetshort

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

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

解説

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

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

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

情報