SOCKET_SECURITY_QUERY_TEMPLATE 結構 (mstcpip.h)

發行項
02/29/2024

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結構可能包含所有成員要求預設安全性資訊的零。

如果SOCKET_SECURITY_QUERY_TEMPLATE結構是以未指定之 PeerTokenAccessMask 成員 (設定為零) ，則 WSAQuerySocketSecurity 函式不會傳回 SOCKET_SECURITY_QUERY_INFO 結構中的 PeerApplicationAccessTokenHandle 和 PeerMachineAccessTokenHandle 成員。

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

規格需求

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