структура 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
Маска доступа, используемая для открытия однорангового приложения пользователя и маркеров компьютера, которые возвращаются в составе сведений запроса.
Комментарии
Структура SOCKET_SECURITY_QUERY_TEMPLATE поддерживается в Windows Vista и более поздних версиях.
Структура SOCKET_SECURITY_QUERY_TEMPLATE используется функцией WSAQuerySocketSecurity для указания типа сведений запроса, возвращаемых для сокета. Структура SOCKET_SECURITY_QUERY_TEMPLATE , передаваемая в функцию WSAQuerySocketSecurity , может содержать нули для всех членов для запроса сведений о безопасности по умолчанию.
Если структура SOCKET_SECURITY_QUERY_TEMPLATE указана с не указанным элементом PeerTokenAccessMask (значение равно нулю), то функция WSAQuerySocketSecurity не вернет элементы PeerApplicationAccessTokenHandle и PeerMachineAccessTokenHandle в структуре SOCKET_SECURITY_QUERY_INFO .
В настоящее время единственным поддерживаемым типом протокола безопасности является протокол IPsec. Таким образом, указание значения перечисления SOCKET_SECURITY_PROTOCOL_DEFAULT для элемента SecurityProtocol аналогично указанию SOCKET_SECURITY_PROTOCOL_IPSEC.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows Vista [только классические приложения] |
Минимальная версия сервера | Windows Server 2008 [только классические приложения] |
Верхняя часть | mstcpip.h |
См. также раздел
Использование расширений secure socket