estrutura SOCKET_PEER_TARGET_NAME (mstcpip.h)

Artigo
03/15/2023

A estrutura SOCKET_PEER_TARGET_NAME contém o endereço IP e o nome de um destino par e o tipo de protocolo de segurança a ser usado em um soquete.

Sintaxe

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

Membros

SecurityProtocol

Um valor SOCKET_SECURITY_PROTOCOL que identifica o tipo de protocolo usado para proteger o tráfego no soquete.

PeerAddress

O endereço IP do par para o soquete.

PeerTargetNameStringLen

O comprimento, em bytes, do nome de destino do par no membro AllStrings .

AllStrings[0]

O nome de destino do par para o soquete.

Comentários

A estrutura de SOCKET_PEER_TARGET_NAME tem suporte no Windows Vista e posterior.

A estrutura SOCKET_PEER_TARGET_NAME é usada pela função WSASetSocketPeerTargetName para especificar o nome de destino do par que corresponde a um endereço IP par. Esse nome de destino deve ser especificado por aplicativos cliente para identificar com segurança o par que deve ser autenticado.

Atualmente, o único tipo de protocolo de segurança com suporte é o IPsec. Portanto, especificar um valor de enumeração de SOCKET_SECURITY_PROTOCOL_DEFAULT tem o mesmo efeito que especificar SOCKET_SECURITY_PROTOCOL_IPSEC no membro SecurityProtocol .

A implementação do IPsec no Windows Vista e no Windows Server 2008 dá suporte apenas à autenticação computador a computador e de usuário para computador. Como resultado, o nome de destino do par especificado no membro AllStrings da estrutura SOCKET_PEER_TARGET_NAME deve se referir à entidade de segurança do computador par.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho	mstcpip.h