PROTOCOL_INFOA構造体 (nspapi.h)
PROTOCOL_INFO構造体には、プロトコルに関する情報が含まれています。
構文
typedef struct _PROTOCOL_INFOA {
DWORD dwServiceFlags;
INT iAddressFamily;
INT iMaxSockAddr;
INT iMinSockAddr;
INT iSocketType;
INT iProtocol;
DWORD dwMessageSize;
LPSTR lpProtocol;
} PROTOCOL_INFOA, *PPROTOCOL_INFOA, *LPPROTOCOL_INFOA;
メンバー
dwServiceFlags
型: DWORD
プロトコルによって提供されるサービスを指定するビット フラグのセット。 次のビット フラグの 1 つ以上を設定できます。
iAddressFamily
型: INT
プロトコルのソケットを開くためにソケット関数が呼び出されたときに af パラメーターとして渡す値。 このアドレス ファミリ値は、プロトコルで使用されるプロトコル アドレスの構造 ( sockaddr 構造体とも呼ばれます) を一意に定義します。
iMaxSockAddr
型: INT
プロトコルでサポートされるソケット アドレスの最大長 (バイト単位)。
iMinSockAddr
型: INT
プロトコルでサポートされるソケット アドレスの最小長 (バイト単位)。
iSocketType
型: INT
プロトコルのソケットを開くためにソケット関数が呼び出されたときに型パラメーターとして渡す値。
XP_PSEUDO_STREAMが dwServiceFlags で設定されている場合、アプリケーションは iSocketType の値に関係なく、ソケットの型パラメーターとしてSOCK_STREAMを指定できます。
iProtocol
型: INT
プロトコルのソケットを開くためにソケット関数が呼び出されたときにプロトコル パラメーターとして渡す値。
dwMessageSize
型: DWORD
プロトコルでサポートされる最大メッセージ サイズ (バイト単位)。 これは、ホストとの間で送受信できるメッセージの最大サイズです。 メッセージ フレーミングをサポートしていないプロトコルの場合、特定のアドレスに送信できるメッセージの実際の最大サイズがこの値より小さい場合があります。
次の特殊なメッセージ・サイズ値が定義されています。
| 値 | 意味 |
|---|---|
|
プロトコルはストリーム指向です。メッセージ サイズの概念は関係ありません。 |
|
プロトコルはメッセージ指向ですが、最大メッセージ サイズはありません。 |
lpProtocol
種類: LPTSTR
プロトコルの名前を提供する 0 で終わる文字列へのポインター。たとえば、"SPX2" などです。
注釈
注意
nspapi.h ヘッダーは、PROTOCOL_INFOをエイリアスとして定義します。これは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| Header | nspapi.h |