SOCKET_PEER_TARGET_NAME 结构 (mstcpip.h)

项目
03/05/2024

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]

套接字的对等目标名称。

注解

Windows Vista 及更高版本支持 SOCKET_PEER_TARGET_NAME 结构。

WSASetSocketPeerTargetName 函数使用 SOCKET_PEER_TARGET_NAME 结构来指定与对等 IP 地址相对应的对等目标名称。此目标名称应由客户端应用程序指定，以便安全地标识应进行身份验证的对等方。

目前，唯一支持的安全协议类型是 IPsec。因此，将枚举值指定为 SOCKET_SECURITY_PROTOCOL_DEFAULT 的效果与在 SecurityProtocol 成员中指定SOCKET_SECURITY_PROTOCOL_IPSEC的效果相同。

Windows Vista 和 Windows Server 2008 上的 IPsec 实现仅支持计算机到计算机和用户到计算机身份验证。因此，在 SOCKET_PEER_TARGET_NAME 结构的 AllStrings 成员中指定的对等目标名称应引用对等计算机主体。

要求

要求	值
最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 [仅限桌面应用]
标头	mstcpip.h