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

  • Статья

Структура SOCKET_SECURITY_SETTINGS определяет общие требования к безопасности для сокета.

Синтаксис

typedef struct _SOCKET_SECURITY_SETTINGS {
  SOCKET_SECURITY_PROTOCOL SecurityProtocol;
  ULONG                    SecurityFlags;
} SOCKET_SECURITY_SETTINGS;

Члены

SecurityProtocol

Значение SOCKET_SECURITY_PROTOCOL , определяющее тип протокола безопасности, используемого в сокете.

SecurityFlags

Набор флагов, позволяющих приложениям устанавливать определенные требования к безопасности в сокете. Возможные значения определяются в файле заголовка Mstcpip.h .

Значение Значение
SOCKET_SETTINGS_GUARANTEE_ENCRYPTION
0x00000001
 Указывает, что требуется гарантированное шифрование трафика. Этот флаг следует установить, если политика по умолчанию предпочитает методы защиты, которые не используют шифрование. Если этот флаг установлен и шифрование по какой-либо причине невозможно, пакеты не будут отправляться и подключение не будет установлено.
SOCKET_SETTINGS_ALLOW_INSECURE
0x00000002
 Указывает, что соединения с прозрачным текстом разрешены. Если этот флаг установлен, некоторые или все отправленные пакеты будут отправляться в виде чистого текста, особенно если не удалось согласовать безопасность с одноранговым элементом.
Примечание Если этот флаг не установлен, гарантируется, что пакеты никогда не будут отправляться в виде ясного текста, даже если согласование безопасности завершается сбоем.
 

Комментарии

Структура SOCKET_SECURITY_SETTINGS поддерживается в Windows Vista и более поздних версиях.

Структура SOCKET_SECURITY_SETTINGS используется функцией WSASetSocketSecurity для включения и применения безопасности к сокету.

Параметры безопасности, не рассматриваемые в этой структуре, являются производными от системной политики по умолчанию или политики, настроенной администратором. Рекомендуется, чтобы большинство приложений указали значение SOCKET_SECURITY_PROTOCOL_DEFAULT для перечисления SOCKET_SECURITY_PROTOCOL в элементе SecurityProtocol . Это делает приложение нейтральным по отношению к протоколам безопасности и упрощает развертывание в разных системах.

Расширенные приложения могут указать протокол безопасности и связанные параметры, приведение их к типу SOCKET_SECURITY_SETTINGS .

Требования

   
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Верхняя часть mstcpip.h

См. также раздел

SOCKET_SECURITY_PROTOCOL

Использование расширений безопасных сокетов

WSASetSocketSecurity

Платформа фильтрации Windows

Функции API платформы фильтрации Windows

Расширения Winsock Secure Socket