CSADDR_INFO 構造体 (nspapi.h)

[アーティクル]
03/13/2024

CSADDR_INFO構造体には、ソケット、ネットワークサービス、または名前空間プロバイダーの Windows ソケットアドレス情報が含まれています。

構文

typedef struct _CSADDR_INFO {
  SOCKET_ADDRESS LocalAddr;
  SOCKET_ADDRESS RemoteAddr;
  INT            iSocketType;
  INT            iProtocol;
} CSADDR_INFO, *PCSADDR_INFO, *LPCSADDR_INFO;

メンバー

LocalAddr

種類: SOCKET_ADDRESS

Windows ソケットのローカルアドレス。

クライアントアプリケーションで、このアドレスを バインド 関数に渡して、ネットワークサービスへのアクセスを取得します。

ネットワークサービスで、このアドレスを バインド 関数に渡して、サービスが適切なローカルアドレスにバインドされるようにします。

RemoteAddr

種類: SOCKET_ADDRESS

Windows ソケットのリモートアドレス。

このリモートアドレスにはいくつかの用途があります。

このリモートアドレスを使用して、connect 関数を使用してサービスに接続できます。これは、アプリケーションが接続指向プロトコルを含む送信/受信操作を実行する場合に便利です。
このリモートアドレスは、コネクションレス (データグラム) プロトコル経由で通信する場合に sendto 関数と共に使用できます。 UDP などのコネクションレスプロトコルを使用している場合、 sendto は通常、リモートシステムにデータを渡す方法です。

iSocketType

型: INT

Windows ソケットの種類。ソケットの種類に使用できる値は、 Winsock2.h ヘッダーファイルで定義されています。

次の表に、Windows ソケット 2 でサポートされる使用可能な値を示します。

値	意味
Sock_stream	ストリームソケット。これは、メッセージ境界のないバイトストリームとしてデータを送信するプロトコルです。このソケット型は、OOB データ転送メカニズムを備えた、シーケンス化された信頼性の高い双方向の接続ベースのバイトストリームを提供します。このソケットの種類は、インターネットアドレスファミリ (AF_INET または AF_INET6) に伝送制御プロトコル (TCP) を使用します。
SOCK_DGRAM	データグラムソケット。このソケット型は、固定 (通常は小さい) 最大長のコネクションレスで信頼性の低いバッファーであるデータグラムをサポートします。このソケットの種類では、インターネットアドレスファミリ (AF_INET または AF_INET6) にユーザーデータグラムプロトコル (UDP) が使用されます。サービスは recvfrom 関数を使用してデータグラムを取得します。リッスン関数と受け入れ関数は、データグラムでは機能しません。
SOCK_RDM	信頼性の高いメッセージデータグラムソケット。このソケット型は、データ内のメッセージ境界を保持します。この種類の例として、Windows でのプラグマティック一般マルチキャスト (PGM) マルチキャストプロトコルの実装があります。これは、信頼性の高いマルチキャストプログラミングと呼ばれることがよくあります。
SOCK_SEQPACKET	シーケンス化されたパケットストリームソケット。このソケットの種類は、データグラムに基づいて擬似ストリームパケットを提供します。

iProtocol

型: INT

使用されるプロトコル。 protocol パラメーターに指定できるオプションは、指定されたアドレスファミリとソケットの種類に固有です。指定できる値は、 Winsock2.h ヘッダーファイルと Wsrm.h ヘッダーファイルで定義されます。

Windows Vista 以降でリリースされたWindows SDKでは、ヘッダーファイルのorganizationが変更され、このパラメーターには、Ws2def.h ヘッダーファイルで定義されている IPPROTO 列挙型の値のいずれかを指定できます。 Ws2def.h ヘッダーファイルは Winsock2.h に自動的に含まれるので、直接使用しないでください。

次の表に 、プロトコル の一般的な値を示しますが、他の多くの値を使用できます。

protocol	意味
IPPROTO_TCP 6	伝送制御プロトコル (TCP)。これは、アドレスファミリが AF_INET または AF_INET6 で、iSocketType メンバーが SOCK_STREAMされている場合に使用できる値です。
IPPROTO_UDP 17	ユーザーデータグラムプロトコル (UDP)。これは、アドレスファミリが AF_INET または AF_INET6 で、iSocketType メンバーが SOCK_DGRAM場合に使用できる値です。
IPPROTO_RM 113	信頼性の高いマルチキャスト用の PGM プロトコル。これは、アドレスファミリが AF_INET され、 iSocketType メンバーが SOCK_RDMされている場合に使用できる値です。 Windows Vista 以降用にリリースされたWindows SDKでは、この値は IPPROTO_PGM とも呼ばれます。

注釈

GetAddressByName 関数は、CSADDR_INFO構造体を使用して Windows ソケットのアドレス情報を取得します。

SO_BSP_STATE ソケットオプションを指定して呼び出された getsockopt 関数は、指定されたソケットのCSADDR_INFO構造体を取得します。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
Header	nspapi.h (Nspapi.h を含む)