структура SOCKET_PEER_TARGET_NAME (mstcpip.h)

Статья
08/25/2023

Структура SOCKET_PEER_TARGET_NAME содержит IP-адрес и имя целевого узла, а также тип протокола безопасности, используемого в сокете.

Синтаксис

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

Члены

SecurityProtocol

Значение SOCKET_SECURITY_PROTOCOL , определяющее тип протокола, используемого для защиты трафика в сокете.

PeerAddress

IP-адрес однорангового узла для сокета.

PeerTargetNameStringLen

Длина (в байтах) имени целевого узла в элементе AllStrings .

AllStrings[0]

Имя целевого объекта однорангового узла для сокета.

Структура SOCKET_PEER_TARGET_NAME используется функцией WSASetSocketPeerTargetName для указания имени целевого узла, соответствующего IP-адресу однорангового узла. Это целевое имя должно быть указано клиентскими приложениями для безопасной идентификации однорангового узла, который должен пройти проверку подлинности.

В настоящее время единственным поддерживаемым типом протокола безопасности является протокол IPsec. Таким образом, указание значения перечисления SOCKET_SECURITY_PROTOCOL_DEFAULT имеет тот же эффект, что и указание SOCKET_SECURITY_PROTOCOL_IPSEC в элементе SecurityProtocol .

Реализация IPsec в Windows Vista и Windows Server 2008 поддерживает только проверку подлинности между компьютерами и пользователями. В результате имя целевого объекта однорангового узла, указанное в элементе AllStrings структуры SOCKET_PEER_TARGET_NAME , должно ссылаться на участника однорангового компьютера.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Верхняя часть	mstcpip.h