estructura SOCKET_PEER_TARGET_NAME (mstcpip.h)

Artículo
02/29/2024

La estructura SOCKET_PEER_TARGET_NAME contiene la dirección IP y el nombre de un destino del mismo nivel y el tipo de protocolo de seguridad que se va a usar en un socket.

Sintaxis

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

Miembros

SecurityProtocol

Valor SOCKET_SECURITY_PROTOCOL que identifica el tipo de protocolo utilizado para proteger el tráfico en el socket.

PeerAddress

Dirección IP del mismo nivel para el socket.

PeerTargetNameStringLen

Longitud, en bytes, del nombre de destino del mismo nivel en el miembro AllStrings .

AllStrings[0]

Nombre de destino del mismo nivel para el socket.

Comentarios

La estructura de SOCKET_PEER_TARGET_NAME se admite en Windows Vista y versiones posteriores.

La estructura de SOCKET_PEER_TARGET_NAME la usa la función WSASetSocketPeerTargetName para especificar el nombre de destino del mismo nivel que corresponde a una dirección IP del mismo nivel. Las aplicaciones cliente especifican este nombre de destino para identificar de forma segura el elemento del mismo nivel que se debe autenticar.

Actualmente, el único tipo de protocolo de seguridad que se admite es IPsec. Por lo tanto, especificar un valor de enumeración de SOCKET_SECURITY_PROTOCOL_DEFAULT tiene el mismo efecto que especificar SOCKET_SECURITY_PROTOCOL_IPSEC en el miembro SecurityProtocol .

La implementación de IPsec en Windows Vista y Windows Server 2008 solo admite la autenticación de equipo a equipo y de usuario a equipo. Como resultado, el nombre de destino del mismo nivel especificado en el miembro AllStrings de la estructura SOCKET_PEER_TARGET_NAME debe hacer referencia a la entidad de seguridad del equipo del mismo nivel.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado	mstcpip.h