estructura SOCKET_SECURITY_QUERY_TEMPLATE (mstcpip.h)

Artículo
03/05/2024

La estructura SOCKET_SECURITY_QUERY_TEMPLATE contiene la plantilla de seguridad usada por la función WSAQuerySocketSecurity .

Sintaxis

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

Miembros

SecurityProtocol

Valor de SOCKET_SECURITY_PROTOCOL que identifica el protocolo utilizado para proteger el tráfico.

PeerAddress

Dirección IP del mismo nivel para la que se consulta la información de seguridad. En el caso de los sockets orientados a la conexión (protocolo de IPPROTO_TCP), el socket conectado identifica de forma única un elemento del mismo nivel. En este caso, este parámetro se omite.

PeerTokenAccessMask

Máscara de acceso usada para abrir la aplicación de usuario del mismo nivel y los identificadores de token de equipo que se devuelven como parte de la información de consulta.

Comentarios

La estructura SOCKET_SECURITY_QUERY_TEMPLATE se admite en Windows Vista y versiones posteriores.

La función WSAQuerySocketSecurity usa la estructura SOCKET_SECURITY_QUERY_TEMPLATE para especificar el tipo de información de consulta que se va a devolver para un socket. La estructura SOCKET_SECURITY_QUERY_TEMPLATE pasada a la función WSAQuerySocketSecurity puede contener ceros para que todos los miembros soliciten información de seguridad predeterminada.

Si la estructura SOCKET_SECURITY_QUERY_TEMPLATE se especifica con el miembro PeerTokenAccessMask no especificado (establecido en cero), la función WSAQuerySocketSecurity no devolverá los miembros PeerApplicationAccessTokenHandle y PeerMachineAccessTokenHandle en la estructura SOCKET_SECURITY_QUERY_INFO .

Actualmente, el único tipo de protocolo de seguridad que se admite es IPsec. Por lo tanto, especificar un valor de enumeración de SOCKET_SECURITY_PROTOCOL_DEFAULT para el miembro SecurityProtocol tiene el mismo efecto que especificar SOCKET_SECURITY_PROTOCOL_IPSEC.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado	mstcpip.h