structure SOCKET_PEER_TARGET_NAME (mstcpip.h)

Article
03/15/2023

La structure SOCKET_PEER_TARGET_NAME contient l’adresse IP et le nom d’une cible homologue et 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 de la cible homologue dans le membre AllStrings .

AllStrings[0]

Nom de la cible homologue pour le socket.

Notes

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 de la cible homologue qui correspond à une adresse IP 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 ordinateur à ordinateur et utilisateur à ordinateur. Par conséquent, le nom de la cible 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


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