SOCKET_SECURITY_QUERY_TEMPLATE 结构 (mstcpip.h)

项目
02/29/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

用于打开作为查询信息的一部分返回的对等用户应用程序和计算机令牌句柄的访问掩码。

注解

Windows Vista 及更高版本支持 SOCKET_SECURITY_QUERY_TEMPLATE 结构。

WSAQuerySocketSecurity 函数使用 SOCKET_SECURITY_QUERY_TEMPLATE 结构指定要为套接字返回的查询信息的类型。传递给 WSAQuerySocketSecurity 函数的 SOCKET_SECURITY_QUERY_TEMPLATE 结构可能包含请求默认安全信息的所有成员的零。

如果指定SOCKET_SECURITY_QUERY_TEMPLATE结构时未指定 PeerTokenAccessMask 成员 (设置为零) ，则 WSAQuerySocketSecurity 函数将不会返回 SOCKET_SECURITY_QUERY_INFO 结构中的 PeerApplicationAccessTokenHandle 和 PeerMachineAccessTokenHandle 成员。

目前，唯一支持的安全协议类型是 IPsec。因此，为 SecurityProtocol 成员指定枚举值 SOCKET_SECURITY_PROTOCOL_DEFAULT 与指定 SOCKET_SECURITY_PROTOCOL_IPSEC 具有相同的效果。

要求

要求	值
最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 [仅限桌面应用]
标头	mstcpip.h