SOCKET_SECURITY_QUERY_TEMPLATE 構造体 (mstcpip.h)

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

SOCKET_SECURITY_QUERY_TEMPLATE構造体には、WSAQuerySocketSecurity 関数で使用されるセキュリティテンプレートが含まれています。

構文

typedef struct _SOCKET_SECURITY_QUERY_TEMPLATE {
  SOCKET_SECURITY_PROTOCOL SecurityProtocol;
  SOCKADDR_STORAGE         PeerAddress;
  ULONG                    PeerTokenAccessMask;
} SOCKET_SECURITY_QUERY_TEMPLATE;

メンバー

SecurityProtocol

トラフィックのセキュリティ保護に使用されるプロトコルを識別する SOCKET_SECURITY_PROTOCOL 値。

PeerAddress

セキュリティ情報のクエリを実行するピアの IP アドレス。接続指向ソケット ( IPPROTO_TCPのプロトコル) の場合、接続されたソケットはピアを一意に識別します。この場合、このパラメーターは無視されます。

PeerTokenAccessMask

クエリ情報の一部として返されるピアユーザーアプリケーションとコンピュータートークンハンドルを開くときに使用されるアクセスマスク。

注釈

SOCKET_SECURITY_QUERY_TEMPLATE構造は、Windows Vista 以降でサポートされています。

SOCKET_SECURITY_QUERY_TEMPLATE構造体は、ソケットに対して返されるクエリ情報の種類を指定するために WSAQuerySocketSecurity 関数によって使用されます。 WSAQuerySocketSecurity 関数に渡されるSOCKET_SECURITY_QUERY_TEMPLATE構造体には、すべてのメンバーが既定のセキュリティ情報を要求するための 0 が含まれている場合があります。

peerTokenAccessMask メンバーが指定されていない (ゼロに設定されている) SOCKET_SECURITY_QUERY_TEMPLATE構造体が指定されている場合、WSAQuerySocketSecurity 関数は、SOCKET_SECURITY_QUERY_INFO構造体の PeerApplicationAccessTokenHandle および PeerMachineAccessTokenHandle メンバーを返しません。

現在、サポートされているセキュリティプロトコルの種類は IPsec のみです。そのため、SecurityProtocol メンバーに対して SOCKET_SECURITY_PROTOCOL_DEFAULT の列挙値を指定すると、SOCKET_SECURITY_PROTOCOL_IPSECを指定する場合と同じ効果があります。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップアプリのみ]
Header	mstcpip.h