WSAHtons 関数 (winsock2.h)

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.1Windows 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

こちらもご覧ください

InetNtop

WSAHtonl

WSANtohl

WSANtohs

Winsock 関数

Winsock リファレンス

htonl

htons

inet_addr

inet_ntoa

ntohl

ntohs