structure SOCKET_SECURITY_QUERY_TEMPLATE (mstcpip.h)

Article
02/29/2024

La structure SOCKET_SECURITY_QUERY_TEMPLATE contient le modèle de sécurité utilisé par la fonction WSAQuerySocketSecurity .

Syntaxe

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

Membres

SecurityProtocol

Valeur SOCKET_SECURITY_PROTOCOL qui identifie le protocole utilisé pour sécuriser le trafic.

PeerAddress

Adresse IP de l’homologue pour lequel les informations de sécurité sont interrogées. Pour les sockets orientés connexion (protocole de IPPROTO_TCP), le socket connecté identifie de manière unique un homologue. Dans ce cas, ce paramètre est ignoré.

PeerTokenAccessMask

Masque d’accès utilisé pour ouvrir l’application utilisateur homologue et les poignées de jeton d’ordinateur retournées dans le cadre des informations de requête.

Remarques

La structure SOCKET_SECURITY_QUERY_TEMPLATE est prise en charge sur Windows Vista et versions ultérieures.

La structure SOCKET_SECURITY_QUERY_TEMPLATE est utilisée par la fonction WSAQuerySocketSecurity pour spécifier le type d’informations de requête à retourner pour un socket. La structure SOCKET_SECURITY_QUERY_TEMPLATE passée à la fonction WSAQuerySocketSecurity peut contenir des zéros pour que tous les membres demandent des informations de sécurité par défaut.

Si la structure SOCKET_SECURITY_QUERY_TEMPLATE est spécifiée avec le membre PeerTokenAccessMask non spécifié (défini sur zéro), la fonction WSAQuerySocketSecurity ne retourne pas les membres PeerApplicationAccessTokenHandle et PeerMachineAccessTokenHandle dans la structure SOCKET_SECURITY_QUERY_INFO .

Actuellement, le seul type de protocole de sécurité pris en charge est IPsec. Par conséquent, la spécification d’une valeur d’énumération de SOCKET_SECURITY_PROTOCOL_DEFAULT pour le membre SecurityProtocol a le même effet que la spécification de SOCKET_SECURITY_PROTOCOL_IPSEC.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
En-tête	mstcpip.h