Função QueryCredentialsAttributesW (sspi.h)

Recupera 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

KSECDDDECLSPEC SECURITY_STATUS SEC_ENTRY QueryCredentialsAttributesW(
  [in]  PCredHandle   phCredential,
  [in]  unsigned long ulAttribute,
  [out] void          *pBuffer
);

Parâmetros

[in] phCredential

Um identificador das credenciais a serem consultadas.

[in] ulAttribute

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

Valor Significado
SECPKG_CRED_ATTR_CERT
Retorna a impressão digital do certificado em um pbuffer do tipo SecPkgCredentials_Cert.

Esse atributo só tem suporte do Kerberos.

Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Esse atributo não está disponível.

SECPKG_CRED_ATTR_NAMES
Retorna o nome de uma credencial em um pbuffer do tipo SecPkgCredentials_Names.

Esse atributo não tem suporte do Schannel no modo WOW64.

SECPKG_ATTR_SUPPORTED_ALGS
Retorna os algoritmos com suporte em um 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
Retorna os pontos fortes de codificação em um pbuffer do tipo SecPkgCred_CipherStrengths.

Esse atributo tem suporte apenas pelo Schannel.

SECPKG_ATTR_SUPPORTED_PROTOCOLS
Retorna os algoritmos com suporte em um 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.

[out] pBuffer

Um ponteiro para um buffer que recebe o atributo solicitado. O tipo de estrutura retornada depende do valor de ulAttribute.

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
A memória disponível não é suficiente para concluir a solicitação.

Comentários

A função QueryCredentialsAttributes permite que um aplicativo determine várias características de uma credencial, incluindo o nome associado às credenciais especificadas.

Consultar o atributo SECPKG_ATTR_CIPHER_STRENGTHS retorna uma estrutura SecPkgCred_CipherStrengths . A força da criptografia nessa estrutura é a mesma que a força da criptografia na estrutura SCH_CREDENTIALS usada quando uma credencial foi criada.

Nota Um aplicativo pode encontrar a força de criptografia padrão do sistema consultando esse atributo com uma credencial padrão. Uma credencial padrão é criada chamando AcquireCredentialsHandle com um parâmetro nullpAuthData .
 
Consultar o atributo SECPKG_ATTR_SUPPORTED_ALGS retorna uma estrutura SecPkgCred_SupportedAlgs . Os algoritmos nessa estrutura são compatíveis com os indicados na estrutura SCH_CREDENTIALS usada quando uma credencial foi criada.

Consultar o atributo SECPKG_ATTR_SUPPORTED_PROTOCOLS retorna uma estrutura SecPkgCred_SupportedProtocols que contém uma matriz de bits compatível com o campo grbitEnabledProtocols da estrutura SCH_CREDENTIALS .

O chamador deve alocar a estrutura apontada pelo parâmetro pBuffer . O pacote de segurança aloca o buffer para qualquer ponteiro retornado na estrutura pBuffer . O chamador pode chamar a função FreeContextBuffer para liberar os ponteiros alocados pelo pacote de segurança.

Observação

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

Confira também

Acquirecredentialshandle

Freecontextbuffer

SCH_CREDENTIALS

Funções SSPI

SecPkgCred_CipherStrengths

SecPkgCred_SupportedAlgs

SecPkgCred_SupportedProtocols

SecPkgCredentials_Names