estructura SOCKET_SECURITY_SETTINGS (mstcpip.h)

  • Artículo

La estructura SOCKET_SECURITY_SETTINGS especifica los requisitos de seguridad genéricos para un socket.

Sintaxis

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

Members

SecurityProtocol

Valor SOCKET_SECURITY_PROTOCOL que identifica el tipo de protocolo de seguridad que se va a usar en el socket.

SecurityFlags

Conjunto de marcas que permiten a las aplicaciones establecer requisitos de seguridad específicos en un socket. Los valores posibles se definen en el archivo de encabezado Mstcpip.h .

Valor Significado
SOCKET_SETTINGS_GUARANTEE_ENCRYPTION
0x00000001
 Indica que se requiere el cifrado garantizado del tráfico. Esta marca debe establecerse si la directiva predeterminada prefiere métodos de protección que no usan cifrado. Si se establece esta marca y el cifrado no es posible por ningún motivo, no se enviará ningún paquete y no se establecerá una conexión.
SOCKET_SETTINGS_ALLOW_INSECURE
0x00000002
 Indica que se permiten conexiones de texto no cifrado. Si se establece esta marca, algunos o todos los paquetes enviados se enviarán en texto no cifrado, especialmente si no se pudo negociar la seguridad con el mismo nivel.
Nota Si no se establece esta marca, se garantiza que los paquetes nunca se enviarán en texto no cifrado, incluso si se produce un error en la negociación de seguridad.
 

Comentarios

La estructura SOCKET_SECURITY_SETTINGS se admite en Windows Vista y versiones posteriores.

La función WSASetSocketSecurity usa la estructura SOCKET_SECURITY_SETTINGS para habilitar y aplicar la seguridad en un socket.

La configuración de seguridad no abordada en esta estructura se deriva de la directiva predeterminada del sistema o de la directiva configurada administrativamente. Se recomienda que la mayoría de las aplicaciones especifiquen un valor de SOCKET_SECURITY_PROTOCOL_DEFAULT para la enumeración SOCKET_SECURITY_PROTOCOL en el miembro SecurityProtocol . Esto hace que la aplicación sea neutral para los protocolos de seguridad y permite implementaciones más sencillas entre diferentes sistemas.

Las aplicaciones avanzadas pueden especificar un protocolo de seguridad y la configuración asociada mediante su conversión al tipo de SOCKET_SECURITY_SETTINGS .

Requisitos

   
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado mstcpip.h

Consulte también

SOCKET_SECURITY_PROTOCOL

Uso de extensiones de socket seguro

WSASetSocketSecurity

Plataforma de filtrado de Windows

Funciones de api de plataforma de filtrado de Windows

Extensiones de socket seguro winsock