структура SOCKET_SECURITY_QUERY_TEMPLATE (mstcpip.h)

Статья
03/05/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

Маска доступа, используемая для открытия однорангового приложения пользователя и маркеров компьютера, которые возвращаются в составе сведений запроса.

Структура 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