WSANtohs 関数 (winsock2.h)

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

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

構文

int WSAAPI WSANtohs(
  [in]  SOCKET  s,
  [in]  u_short netshort,
  [out] u_short *lphostshort
);

パラメーター

[in] s

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

[in] netshort

ネットワークバイト順の 16 ビット番号。

[out] lphostshort

ホストのバイト順で番号を受け取る 16 ビット数値へのポインター。

戻り値

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

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

注釈

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

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

WSANtohs 関数では、Winsock DLL が以前に WSAStartup 関数の呼び出しに成功して読み込まれている必要があります。 AF_INET OR AF_INET6 アドレスファミリで使用する場合、 ntohs 関数では 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