Compartilhar via


estrutura SOCKET_SECURITY_SETTINGS (mstcpip.h)

A estrutura SOCKET_SECURITY_SETTINGS especifica requisitos de segurança genéricos para um soquete.

Sintaxe

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

Membros

SecurityProtocol

Um valor SOCKET_SECURITY_PROTOCOL que identifica o tipo de protocolo de segurança a ser usado no soquete.

SecurityFlags

Um conjunto de sinalizadores que permitem que os aplicativos definam requisitos de segurança específicos em um soquete. Os valores possíveis são definidos no arquivo de cabeçalho Mstcpip.h .

Valor Significado
SOCKET_SETTINGS_GUARANTEE_ENCRYPTION
0x00000001
Indica que a criptografia garantida de tráfego é necessária. Esse sinalizador deverá ser definido se a política padrão preferir métodos de proteção que não usam criptografia. Se esse sinalizador estiver definido e a criptografia não for possível por qualquer motivo, nenhum pacote será enviado e uma conexão não será estabelecida.
SOCKET_SETTINGS_ALLOW_INSECURE
0x00000002
Indica que conexões de texto não criptografado são permitidas. Se esse sinalizador for definido, alguns ou todos os pacotes enviados serão enviados em texto não criptografado, especialmente se a segurança com o par não puder ser negociada.
Nota Se esse sinalizador não estiver definido, é garantido que os pacotes nunca serão enviados em texto não criptografado, mesmo que a negociação de segurança falhe.
 

Comentários

A estrutura SOCKET_SECURITY_SETTINGS tem suporte no Windows Vista e posterior.

A estrutura SOCKET_SECURITY_SETTINGS é usada pela função WSASetSocketSecurity para habilitar e aplicar a segurança em um soquete.

As configurações de segurança não abordadas nessa estrutura são derivadas da política padrão do sistema ou da política configurada administrativamente. É recomendável que a maioria dos aplicativos especifique um valor de SOCKET_SECURITY_PROTOCOL_DEFAULT para a enumeração SOCKET_SECURITY_PROTOCOL no membro SecurityProtocol . Isso torna o aplicativo neutro para protocolos de segurança e permite implantações mais fáceis entre diferentes sistemas.

Aplicativos avançados podem especificar um protocolo de segurança e configurações associadas convertendo-os no tipo SOCKET_SECURITY_SETTINGS .

Requisitos

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho mstcpip.h

Confira também

SOCKET_SECURITY_PROTOCOL

Usando extensões de soquete seguro

WSASetSocketSecurity

Plataforma de filtragem do Windows

Funções da API da Plataforma de Filtragem do Windows

Extensões de soquete seguro winsock