WSAHtons 関数 (winsock2.h)

[アーティクル]
08/27/2023

WSAHtons 関数は、u_shortをホストのバイト順からネットワークのバイト順に変換します。

構文

int WSAAPI WSAHtons(
  [in]  SOCKET  s,
  [in]  u_short hostshort,
  [out] u_short *lpnetshort
);

パラメーター

[in] s

ソケットを識別する記述子。

[in] hostshort

ホストのバイト順の 16 ビット番号。

[out] lpnetshort

ネットワークのバイト順で数値を受け取る 16 ビットバッファーへのポインター。

戻り値

エラーが発生しない場合、 WSAHtons は 0 を返します。それ以外の場合は、SOCKET_ERRORの値が返され、 WSAGetLastError を呼び出すことによって特定のエラーコードを取得できます。

エラーコード	意味
WSANOTINITIALIZED	この関数を使用する前に、WSAStartup 呼び出しが正常に行われる必要があります。
WSAENETDOWN	ネットワークサブシステムが失敗しました。
WSAENOTSOCK	記述子はソケットではありません。
WSAEFAULT	lpnetshort パラメーターが NULL であるか、指すアドレスがユーザー・アドレス・スペースの有効な部分に完全に含まれていません。

注釈

WSAHtons 関数は、ホストのバイト順に 16 ビットの数値を受け取り、lpnetshort パラメーターが指す 16 ビット番号でネットワークバイト順に 16 ビットの数値を返します。 s パラメーターで渡されたソケットは、ソケットに関連付けられている Winsock カタログプロトコルエントリに基づいて、必要なネットワークバイト順を決定するために使用されます。この機能は、異なるネットワークバイトオーダーを使用する Winsock プロバイダーをサポートします。

ソケットが AF_INET または AF_INET6 アドレスファミリ用の場合、 WSAHtons 関数を使用して、ホストバイト順の IP ポート番号をネットワークバイト順の IP ポート番号に変換できます。

WSAHtons 関数では、Winsock DLL が以前に WSAStartup 関数の呼び出しに成功して読み込まれている必要があります。 AF_INET OR 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 ストアアプリでサポートされています。

要件

要件	値
サポートされている最小のクライアント	Windows 8.1、 Windows Vista [デスクトップアプリ \|UWP アプリ]
サポートされている最小のサーバー	Windows Server 2003 [デスクトップアプリのみ \| UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	winsock2.h
Library	Ws2_32.lib
[DLL]	Ws2_32.dll