SOCKET_SECURITY_QUERY_TEMPLATE 結構 (mstcpip.h)

發行項
08/25/2023

SOCKET_SECURITY_QUERY_TEMPLATE結構包含WSAQuerySocketSecurity函式所使用的安全性範本。

語法

typedef struct _SOCKET_SECURITY_QUERY_TEMPLATE {
  SOCKET_SECURITY_PROTOCOL SecurityProtocol;
  SOCKADDR_STORAGE         PeerAddress;
  ULONG                    PeerTokenAccessMask;
} SOCKET_SECURITY_QUERY_TEMPLATE;

成員

SecurityProtocol

SOCKET_SECURITY_PROTOCOL值，識別用來保護流量的通訊協定。

PeerAddress

正在查詢安全性資訊的對等 IP 位址。針對 IPPROTO_TCP) 的連線導向通訊端 (通訊協定，連線的通訊端會唯一識別對等。在此情況下，會忽略此參數。

PeerTokenAccessMask

用來開啟對等使用者應用程式和電腦權杖控制碼的存取遮罩，這些控制碼會作為查詢資訊的一部分傳回。

備註

Windows Vista 和更新版本支援 SOCKET_SECURITY_QUERY_TEMPLATE 結構。

WSAQuerySocketSecurity函式會使用SOCKET_SECURITY_QUERY_TEMPLATE結構來指定要針對通訊端傳回的查詢資訊類型。傳遞至WSAQuerySocketSecurity函式的SOCKET_SECURITY_QUERY_TEMPLATE結構可能包含所有成員要求預設安全性資訊的零。

如果使用未指定peerTokenAccessMask成員指定SOCKET_SECURITY_QUERY_TEMPLATE結構， (設定為零) ，則WSAQuerySocketSecurity函式將不會傳回SOCKET_SECURITY_QUERY_INFO結構中的PeerApplicationAccessTokenHandle和PeerMachineAccessTokenHandle成員。

目前唯一支援的安全性通訊協定類型是 IPsec。因此，為SecurityProtocol成員指定SOCKET_SECURITY_PROTOCOL_DEFAULT的列舉值，與指定SOCKET_SECURITY_PROTOCOL_IPSEC的效果相同。

需求


最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
標頭	mstcpip.h