Função SetContextAttributesA (sspi.h)

Artigo
11/20/2024

Permite que um aplicativo de transporte defina atributos de uma de contexto de 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 ser um dos valores a seguir.

Valor	Significado
SECPKG_ATTR_APP_DATA 94	O parâmetro pBuffer contém um ponteiro para uma estrutura 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 SecPkgContext_EarlyStart. Define o recurso False Start. Consulte o Criando uma postagem de blog de da Web mais rápida e segura 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 só tem suporte no pacote de segurança do Schannel no Windows 10 e no Windows Server 2016 ou versões posteriores.

[in] pBuffer

Um ponteiro para uma estrutura que contém valores para os quais 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 de retorno

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.

Observações

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows XP [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	sspi.h (inclua Security.h)
biblioteca	Secur32.lib
de DLL	Secur32.dll

Compartilhar via