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