énumération SOCKET_SECURITY_PROTOCOL (mstcpip.h)

Article
03/04/2024

L’énumération SOCKET_SECURITY_PROTOCOL indique le type de protocole de sécurité à utiliser sur un socket pour sécuriser le trafic réseau.

Syntax

typedef enum _SOCKET_SECURITY_PROTOCOL {
  SOCKET_SECURITY_PROTOCOL_DEFAULT,
  SOCKET_SECURITY_PROTOCOL_IPSEC,
  SOCKET_SECURITY_PROTOCOL_IPSEC2,
  SOCKET_SECURITY_PROTOCOL_INVALID
} SOCKET_SECURITY_PROTOCOL;

Constantes


`SOCKET_SECURITY_PROTOCOL_DEFAULT` La sécurité système par défaut sera utilisée.
`SOCKET_SECURITY_PROTOCOL_IPSEC` IPsec sera utilisé.
`SOCKET_SECURITY_PROTOCOL_IPSEC2`
`SOCKET_SECURITY_PROTOCOL_INVALID` Valeur maximale possible pour le type d’énumération SOCKET_SECURITY_PROTOCOL . Il ne s’agit pas d’une valeur légale.

Remarques

Cette énumération est prise en charge sur Windows Vista et versions ultérieures.

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 a le même effet que la spécification de SOCKET_SECURITY_PROTOCOL_IPSEC.

L’énumération SOCKET_SECURITY_PROTOCOL est utilisée dans les structures SOCKET_PEER_TARGET_NAME, SOCKET_SECURITY_QUERY_INFO, SOCKET_SECURITY_QUERY_TEMPLATE, SOCKET_SECURITY_SETTINGS et SOCKET_SECURITY_SETTINGS_IPSEC pour indiquer le type de protocole de sécurité à utiliser sur un socket dans le membre SecurityProtocol. Ces structures sont utilisées par les fonctions WSAQuerySocketSecurity, WSASetSocketPeerTargetName et WSASetSocketSecurity .

En plus d’identifier le protocole de sécurité, ce type est également utilisé pour décider comment interpréter un pointeur passé à certaines fonctions de socket sécurisé. Cela est analogue à la façon dont le membre sa_family du type sockaddr est utilisé pour interpréter un pointeur comme sockaddr_in ou sockaddr_in6.

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