SOCKET_SECURITY_QUERY_INFO structure (mstcpip.h)

The SOCKET_SECURITY_QUERY_INFO structure contains security information returned by the WSAQuerySocketSecurity function.

Syntax

typedef struct _SOCKET_SECURITY_QUERY_INFO {
  SOCKET_SECURITY_PROTOCOL SecurityProtocol;
  ULONG                    Flags;
  UINT64                   PeerApplicationAccessTokenHandle;
  UINT64                   PeerMachineAccessTokenHandle;
} SOCKET_SECURITY_QUERY_INFO;

Members

SecurityProtocol

A SOCKET_SECURITY_PROTOCOL value that identifies the protocol used to secure the traffic.

Flags

The set of possible security flags for the connection defined in the Mstcpip.h header file.

Value Meaning
SOCKET_INFO_CONNECTION_SECURED
0x00000001
If present, traffic is being secured by a security protocol. If absent, the traffic is flowing in the clear.
SOCKET_INFO_CONNECTION_ENCRYPTED
0x00000002
If present, the connection traffic is being encrypted. The SOCKET_INFO_CONNECTION_SECURED flag is always set when this flag is present.

PeerApplicationAccessTokenHandle

A handle to the access token that represents the account under which the peer application is running. After using the token for access checks, the application should close the handle using the CloseHandle function.

PeerMachineAccessTokenHandle

A handle to the access token for the peer computer's account during the course of the application. After using the token for access checks, the application should close the handle using the CloseHandle function.

Remarks

The SOCKET_SECURITY_QUERY_INFO structure is supported on Windows Vista and later.

The SOCKET_SECURITY_QUERY_INFO structure is used by the WSAQuerySocketSecurity function to return information about the security applied to a connection on a socket.

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

CloseHandle

SOCKET_SECURITY_PROTOCOL

Using Secure Socket Extensions

WSAQuerySocketSecurity

Windows Filtering Platform

Windows Filtering Platform API Functions

Winsock Secure Socket Extensions