Função SetContextAttributesA (sspi.h)
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 SetContextAttributesA(
[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 |
|---|---|
|
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. |
|
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. |
|
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. |
|
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. |
|
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 |
|---|---|
|
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 |