WSADATA 構造体

[アーティクル]
02/21/2013

WSADATA の構造が AfxSocketInit のグローバル関数の呼び出しによって返される Windows ソケット初期化情報を格納するために使用されます。

struct WSAData {
   WORD wVersion;
   WORD wHighVersion;
   char szDescription[WSADESCRIPTION_LEN+1];
   char szSystemStatus[WSASYSSTATUS_LEN+1];
   unsigned short iMaxSockets;
   unsigned short iMaxUdpDg;
   char FAR * lpVendorInfo;
};

パラメーター

wVersion
Windows ソケットの DLL が呼び出し元が使用する、 Windows ソケットの設計のバージョン。
wHighVersion
このサポート DLL ができる Windows ソケット仕様の最上位バージョン（上としてエンコードされます）。通常、これは wVersionと同じです。
szDescription
Windows ソケットの DLL が Windows ソケットの実装についてコピー販売元の ID を含む ASCII の null で終わる文字列。テキスト（長さが 256 文字まで）は、コントロールおよび書式指定文字が含まれていることに対する警告される文字、販売元を含めることができますが: アプリケーションがこれを配置する可能性が高い使用はステータスメッセージの、切り捨てられる（）が表示されます。
szSystemStatus
Windows ソケットの DLL が関連するステータスまたは構成情報をコピーする ASCII の null で終わる文字列。Windows ソケットの DLL は、情報のユーザーまたはサポートスタッフに便利な場合があります。いない場合のみ、このフィールドを使用してください; これは szDescription フィールドの拡張として考慮することはできません。
iMaxSockets
一つのプロセスに、開いているできるソケットの最大数。Windows ソケットの実装は、プロセスにアロケーションのソケットグローバルプールを提供する; 代わりに、ソケットのプロセスごとのリソースを割り当てることができます。数は、 Windows ソケット DLL またはネットワークソフトウェアを構成する方法を反映できます。アプリケーション作成者は粗野な示す値として Windows ソケットの実装をアプリケーションで使用できるかどうかをこの数を使用できます。たとえば、 X Window サーバーは、最初にを起動したとき iMaxSockets をチェックする可能性があります: これは次の値よりも小さい 8、ネットワークソフトウェアアプリケーションを再構成するようにユーザーに指示するエラーメッセージが表示されます。（これは szSystemStatus のテキストが使用される状況です）。マニフェストに使用中の他の Windows ソケットアプリケーションがあるため、特定のアプリケーションが実際に iMaxSockets ソケットを割り当てることができるという保証はありません。
iMaxUdpDg
Windows ソケットのアプリケーションで送信または受信できるユーザーデータグラムプロトコルの (UDP) の最大データグラムのバイトのサイズ。実装が制限を課さなければ、 iMaxUdpDg はゼロです。Berkeley ソケットの多くの実装では、必要に応じて断片化する）の 8192 バイトの暗黙の制限が UDP のデータグラムあります。たとえば、 Windows ソケットの実装は、フラグメントの再なアセンブリバッファーのアロケーションに基づいて制限を課すことができます。対応 Windows ソケットを実装する際の iMaxUdpDg の最小値は 512 です。iMaxUdpDgの値に関係なく、ネットワークの最大伝送単位 (MTU) より大きいブロードキャストなデータグラムを送信すると、非推奨であることに注意してください。（MTU を検出するために Windows ソケット API は機能を提供しません 512 未満のバイトである必要はありません）。
lpVendorInfo
ベンダ別のデータ構造体へのポインターも。（指定されている場合）、この構造体の定義は、 Windows ソケットの仕様では説明しません。

[!メモ]

MFC では、 WSADATA の構造は、 InitInstance 関数でダイヤルする AfxSocketInit の関数によって返されます。これからの情報を後で使用する必要がある場合は、構造体を取得し、プログラムに格納できます。

次の方法で共有

WSADATA 構造体

パラメーター

必要条件

参照

関連項目

その他の技術情報

その他のリソース