SOCKET_SECURITY_QUERY_TEMPLATE 構造体 (mstcpip.h)
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 |