Função SetContextAttributesW (sspi.h)

  • Artigo

Permite que um aplicativo de transporte defina atributos de um contexto de segurança para um pacote de segurança. Essa função só tem suporte no pacote de segurança do Schannel.

Sintaxe

SECURITY_STATUS SEC_ENTRY SetContextAttributesW(
  [in] PCtxtHandle   phContext,
  [in] unsigned long ulAttribute,
  [in] void          *pBuffer,
  [in] unsigned long cbBuffer
);

Parâmetros

[in] phContext

Um identificador para o contexto de segurança a ser definido.

[in] ulAttribute

O atributo do contexto a ser definido. Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
SECPKG_ATTR_APP_DATA
94
 O parâmetro pBuffer contém um ponteiro para uma estrutura de SecPkgContext_SessionAppData .

Define os dados do aplicativo para a sessão.

Esse atributo só tem suporte no pacote de segurança do Schannel.
SECPKG_ATTR_EAP_PRF_INFO
101
 O parâmetro pBuffer contém um ponteiro para uma estrutura de SecPkgContext_EapPrfInfo .

Define a PRF (função pseudo-aleatória) usada pelo Protocolo de Autenticação Extensível (EAP). Esse é o valor retornado por uma chamada para a função QueryContextAttributes (Schannel) quando SECPKG_ATTR_EAP_KEY_BLOCK é passado como o valor do parâmetro ulAttribute .

Esse atributo só tem suporte no pacote de segurança do Schannel.
SECPKG_ATTR_EARLY_START
105
 O parâmetro pBuffer contém um ponteiro para uma estrutura de SecPkgContext_EarlyStart .

Define o recurso De início falso. Consulte a postagem Criar um blog da Web mais rápido e seguro para obter informações sobre esse recurso.
SECPKG_ATTR_DTLS_MTU
34
 Define e recupera o valor mtu (unidade de transmissão máxima) para uso com DTLS. Se o DTLS não estiver habilitado em um contexto de segurança, esse atributo não terá suporte.

Os valores válidos estão entre 200 bytes e 64 quilobytes. O valor de MTU DTLS padrão no Schannel é 1096 bytes.
SECPKG_ATTR_KEYING_MATERIAL_INFO
106
 O parâmetro pBuffer contém um ponteiro para uma estrutura de SecPkgContext_KeyingMaterialInfo . O recurso de exportação de material de chave segue o padrão RFC 5705.

Esse atributo é compatível apenas com o pacote de segurança Schannel no Windows 10 e Windows Server 2016 ou versões posteriores.

[in] pBuffer

Um ponteiro para uma estrutura que contém valores para definir os atributos. O tipo de estrutura apontada depende do valor especificado no parâmetro ulAttribute .

[in] cbBuffer

O tamanho, em bytes, do parâmetro pBuffer .

Valor retornado

Se a função for bem-sucedida, a função retornará SEC_E_OK.

Se a função falhar, ela retornará um código de erro diferente de zero. O código de erro a seguir é um dos códigos de erro possíveis.

Código de retorno Descrição
SEC_E_UNSUPPORTED_FUNCTION
 Esse valor é retornado pelo modo kernel Schannel para indicar que essa função não tem suporte.

Comentários

Observação

O cabeçalho sspi.h define SetContextAttributes como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

   
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho sspi.h (inclua Security.h)
Biblioteca Secur32.lib
DLL Secur32.dll