structure SOCKET_PEER_TARGET_NAME (mstcpip.h)

Article
03/04/2024

La structure SOCKET_PEER_TARGET_NAME contient l’adresse IP et le nom d’une cible homologue, ainsi que le type de protocole de sécurité à utiliser sur un socket.

Syntaxe

typedef struct _SOCKET_PEER_TARGET_NAME {
  SOCKET_SECURITY_PROTOCOL SecurityProtocol;
  SOCKADDR_STORAGE         PeerAddress;
  ULONG                    PeerTargetNameStringLen;
  wchar_t                  AllStrings[0];
} SOCKET_PEER_TARGET_NAME;

Membres

SecurityProtocol

Valeur SOCKET_SECURITY_PROTOCOL qui identifie le type de protocole utilisé pour sécuriser le trafic sur le socket.

PeerAddress

Adresse IP de l’homologue pour le socket.

PeerTargetNameStringLen

Longueur, en octets, du nom cible de l’homologue dans le membre AllStrings .

AllStrings[0]

Nom cible de l’homologue pour le socket.

Remarques

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

La structure SOCKET_PEER_TARGET_NAME est utilisée par la fonction WSASetSocketPeerTargetName pour spécifier le nom cible de l’homologue qui correspond à une adresse IP d’homologue. Ce nom cible est destiné à être spécifié par les applications clientes pour identifier de manière sécurisée l’homologue qui doit être authentifié.

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 dans le membre SecurityProtocol .

L’implémentation d’IPsec sur Windows Vista et Windows Server 2008 prend uniquement en charge l’authentification d’ordinateur à ordinateur et d’utilisateur à ordinateur. Par conséquent, le nom cible de l’homologue spécifié dans le membre AllStrings de la structure SOCKET_PEER_TARGET_NAME doit faire référence au principal de l’ordinateur homologue.

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