SOCKET_SECURITY_QUERY_TEMPLATE 結構 (mstcpip.h)
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 |