Função SetCredentialsAttributesA (sspi.h)

Artigo
03/08/2023

Define os atributos de uma credencial, como o nome associado à credencial. As informações são válidas para qualquer contexto de segurança criado com a credencial especificada.

Sintaxe

SECURITY_STATUS SEC_ENTRY SetCredentialsAttributesA(
  [in] PCredHandle   phCredential,
  [in] unsigned long ulAttribute,
  [in] void          *pBuffer,
       unsigned long cbBuffer
);

Parâmetros

[in] phCredential

Um identificador das credenciais a serem definidas.

[in] ulAttribute

Especifica o atributo a ser definido. Esse parâmetro pode ser qualquer um dos atributos a seguir.

Valor	Significado
SECPKG_CRED_ATTR_NAMES	Define o nome de uma credencial em um parâmetro pBuffer do tipo SecPkgCredentials_Names. Esse atributo não tem suporte do Schannel no modo WOW64.
SECPKG_CRED_ATTR_KDC_PROXY_SETTINGS	Define a configuração de proxy Kerberos em um parâmetro pBuffer do tipo SecPkgCredentials_KdcProxySettings. Esse atributo só tem suporte do Kerberos.
SECPKG_ATTR_SUPPORTED_ALGS	Define os algoritmos com suporte em um parâmetro pBuffer do tipo SecPkgCred_SupportedAlgs. Todos os algoritmos com suporte são incluídos, independentemente de serem compatíveis com o certificado fornecido ou habilitados no computador local. Esse atributo tem suporte apenas pelo Schannel.
SECPKG_ATTR_CIPHER_STRENGTHS	Define os pontos fortes de codificação em um parâmetro pBuffer do tipo SecPkgCred_CipherStrengths. Esse atributo tem suporte apenas pelo Schannel.
SECPKG_ATTR_SUPPORTED_PROTOCOLS	Define os algoritmos com suporte em um parâmetro pBuffer do tipo SecPkgCred_SupportedProtocols. Todos os protocolos com suporte são incluídos, independentemente de serem compatíveis com o certificado fornecido ou habilitados no computador local. Esse atributo tem suporte apenas pelo Schannel.

[in] pBuffer

Um ponteiro para um buffer que contém o novo valor de atributo. O tipo de estrutura retornada depende do valor de ulAttribute.

cbBuffer

O tamanho, em bytes, do buffer pBuffer .

Retornar valor

Se a função for bem-sucedida, o valor retornado será SEC_E_OK.

Se a função falhar, o valor retornado poderá ser um dos seguintes códigos de erro.

Código de retorno	Descrição
SEC_E_INVALID_HANDLE	O identificador passado para a função não é válido.
SEC_E_UNSUPPORTED_FUNCTION	O atributo especificado não tem suporte do Schannel. Esse valor retornado só será retornado quando o SSP do Schannel estiver sendo usado.
SEC_E_INSUFFICIENT_MEMORY	Não há memória suficiente disponível para concluir a solicitação.

Comentários

Observação

O cabeçalho sspi.h define SetCredentialsAttributes 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

Requisito	Valor
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