estrutura SOCKET_SECURITY_QUERY_TEMPLATE (mstcpip.h)

Artigo
03/13/2024

A estrutura SOCKET_SECURITY_QUERY_TEMPLATE contém o modelo de segurança usado pela função WSAQuerySocketSecurity .

Sintaxe

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

Membros

SecurityProtocol

Um valor SOCKET_SECURITY_PROTOCOL que identifica o protocolo usado para proteger o tráfego.

PeerAddress

O endereço IP do par para o qual as informações de segurança estão sendo consultadas. Para soquetes orientados à conexão (protocolo de IPPROTO_TCP), o soquete conectado identifica exclusivamente um par. Nesse caso, esse parâmetro é ignorado.

PeerTokenAccessMask

A máscara de acesso usada para abrir o aplicativo de usuário par e identificadores de token de computador que são retornados como parte das informações da consulta.

Comentários

A estrutura SOCKET_SECURITY_QUERY_TEMPLATE tem suporte no Windows Vista e posterior.

A estrutura SOCKET_SECURITY_QUERY_TEMPLATE é usada pela função WSAQuerySocketSecurity para especificar o tipo de informações de consulta a serem retornadas para um soquete. A estrutura SOCKET_SECURITY_QUERY_TEMPLATE passada para a função WSAQuerySocketSecurity pode conter zeros para todos os membros solicitarem informações de segurança padrão.

Se a estrutura SOCKET_SECURITY_QUERY_TEMPLATE for especificada com o membro PeerTokenAccessMask não especificado (definido como zero), a função WSAQuerySocketSecurity não retornará os membros PeerApplicationAccessTokenHandle e PeerMachineAccessTokenHandle na estrutura SOCKET_SECURITY_QUERY_INFO .

Atualmente, o único tipo de protocolo de segurança com suporte é o IPsec. Portanto, especificar um valor de enumeração de SOCKET_SECURITY_PROTOCOL_DEFAULT para o membro SecurityProtocol tem o mesmo efeito que especificar SOCKET_SECURITY_PROTOCOL_IPSEC.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho	mstcpip.h