SOCKET_SECURITY_QUERY_TEMPLATE structure (mstcpip.h)
The SOCKET_SECURITY_QUERY_TEMPLATE structure contains the security template used by the WSAQuerySocketSecurity function.
Syntax
typedef struct _SOCKET_SECURITY_QUERY_TEMPLATE {
SOCKET_SECURITY_PROTOCOL SecurityProtocol;
SOCKADDR_STORAGE PeerAddress;
ULONG PeerTokenAccessMask;
} SOCKET_SECURITY_QUERY_TEMPLATE;
Members
SecurityProtocol
A SOCKET_SECURITY_PROTOCOL value that identifies the protocol used to secure the traffic.
PeerAddress
The IP address of the peer for which security information is being queried. For connection-oriented sockets (protocol of IPPROTO_TCP), the connected socket uniquely identifies a peer. In this case, this parameter is ignored.
PeerTokenAccessMask
The access mask used for opening the peer user application and computer token handles that are returned as part of the query information.
Remarks
The SOCKET_SECURITY_QUERY_TEMPLATE structure is supported on Windows Vista and later.
The SOCKET_SECURITY_QUERY_TEMPLATE structure is used by the WSAQuerySocketSecurity function to specify the type of query information to return for a socket. The SOCKET_SECURITY_QUERY_TEMPLATE structure passed to the WSAQuerySocketSecurity function may contain zeros for all members to request default security information.
If the SOCKET_SECURITY_QUERY_TEMPLATE structure is specified with the PeerTokenAccessMask member not specified (set to zero), then the WSAQuerySocketSecurity function will not return the PeerApplicationAccessTokenHandle and PeerMachineAccessTokenHandle members in the SOCKET_SECURITY_QUERY_INFO structure.
Currently, the only type of security protocol that is supported is IPsec. So specifying an enumeration value of SOCKET_SECURITY_PROTOCOL_DEFAULT for the SecurityProtocol member has the same effect as specifying SOCKET_SECURITY_PROTOCOL_IPSEC.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista [desktop apps only] |
| Minimum supported server | Windows Server 2008 [desktop apps only] |
| Header | mstcpip.h |
See also
Using Secure Socket Extensions