共用方式為


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 安全套接字延伸模組