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 |