SOCKET_SECURITY_QUERY_INFO structure (mstcpip.h)

Article
08/25/2023

La structure SOCKET_SECURITY_QUERY_INFO contient des informations de sécurité retournées par la fonction WSAQuerySocketSecurity .

Syntaxe

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

Membres

SecurityProtocol

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

Flags

Ensemble d’indicateurs de sécurité possibles pour la connexion définie dans le fichier d’en-tête Mstcpip.h .

Valeur	Signification
SOCKET_INFO_CONNECTION_SECURED 0x00000001	Le cas échéant, le trafic est sécurisé par un protocole de sécurité. En cas d’absence, le trafic circule en clair.
SOCKET_INFO_CONNECTION_ENCRYPTED 0x00000002	Le cas échéant, le trafic de connexion est chiffré. L’indicateur SOCKET_INFO_CONNECTION_SECURED est toujours défini lorsque cet indicateur est présent.

PeerApplicationAccessTokenHandle

Handle du jeton d’accès qui représente le compte sous lequel l’application homologue s’exécute. Après avoir utilisé le jeton pour les vérifications d’accès, l’application doit fermer le handle à l’aide de la fonction CloseHandle .

PeerMachineAccessTokenHandle

Handle du jeton d’accès pour le compte de l’ordinateur homologue au cours de l’application. Après avoir utilisé le jeton pour les vérifications d’accès, l’application doit fermer le handle à l’aide de la fonction CloseHandle .

Notes

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

La structure SOCKET_SECURITY_QUERY_INFO est utilisée par la fonction WSAQuerySocketSecurity pour retourner des informations sur la sécurité appliquée à une connexion sur un socket.

Spécifications


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