SOCKET_PEER_TARGET_NAME 结构 (mstcpip.h)

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

另请参阅

SOCKADDR_STORAGE

SOCKET_SECURITY_PROTOCOL

使用安全套接字扩展

WSASetSocketPeerTargetName

Windows 筛选平台

Windows 筛选平台 API 函数

Winsock 安全套接字扩展