SOCKET_SECURITY_QUERY_TEMPLATE struttura (mstcpip.h)

Articolo
02/29/2024

La struttura SOCKET_SECURITY_QUERY_TEMPLATE contiene il modello di sicurezza usato dalla funzione WSAQuerySocketSecurity .

Sintassi

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

Members

SecurityProtocol

Valore SOCKET_SECURITY_PROTOCOL che identifica il protocollo usato per proteggere il traffico.

PeerAddress

Indirizzo IP del peer per cui vengono eseguite query sulle informazioni di sicurezza. Per i socket orientati alla connessione (protocollo di IPPROTO_TCP), il socket connesso identifica in modo univoco un peer. In questo caso, questo parametro viene ignorato.

PeerTokenAccessMask

Maschera di accesso usata per aprire l'applicazione utente peer e gli handle di token computer restituiti come parte delle informazioni di query.

Commenti

La struttura SOCKET_SECURITY_QUERY_TEMPLATE è supportata in Windows Vista e versioni successive.

La struttura SOCKET_SECURITY_QUERY_TEMPLATE viene usata dalla funzione WSAQuerySocketSecurity per specificare il tipo di informazioni di query da restituire per un socket. La struttura SOCKET_SECURITY_QUERY_TEMPLATE passata alla funzione WSAQuerySocketSecurity può contenere zero per tutti i membri per richiedere informazioni di sicurezza predefinite.

Se la struttura SOCKET_SECURITY_QUERY_TEMPLATE viene specificata con il membro PeerTokenAccessMask non specificato (impostato su zero), la funzione WSAQuerySocketSecurity non restituirà i membri PeerApplicationAccessTokenHandle e PeerMachineAccessTokenHandle nella struttura SOCKET_SECURITY_QUERY_INFO .

Attualmente, l'unico tipo di protocollo di sicurezza supportato è IPsec. Pertanto, specificando un valore di enumerazione di SOCKET_SECURITY_PROTOCOL_DEFAULT per il membro SecurityProtocol , si verifica lo stesso effetto della specifica di SOCKET_SECURITY_PROTOCOL_IPSEC.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Intestazione	mstcpip.h