Função de retorno de chamada SpQueryCredentialsAttributesFn (ntsecpkg.h)

  • Artigo

A função SpQueryCredentialsAttributes recupera os atributos de uma credencial.

A função SpQueryCredentialsAttributes é a função de expedição para a função QueryCredentialsAttributes da Interface do Provedor de Suporte de Segurança.

Sintaxe

SpQueryCredentialsAttributesFn Spquerycredentialsattributesfn;

NTSTATUS Spquerycredentialsattributesfn(
  [in]  LSA_SEC_HANDLE CredentialHandle,
  [in]  ULONG CredentialAttribute,
  [out] PVOID Buffer
)
{...}

Parâmetros

[in] CredentialHandle

Um identificador para a credencial a ser consultada.

[in] CredentialAttribute

Atributo para consulta. A tabela a seguir lista os valores válidos.

Valor Significado
SECPKG_CRED_ATTR_NAMES
 O nome da entidade de segurança associada às credenciais.
SECPKG_ATTR_SUPPORTED_ALGS
 Os algoritmos com suporte com uma credencial específica.
SECPKG_ATTR_CIPHER_STRENGTHS
 A força mínima e máxima da criptografia usada com uma credencial.
SECPKG_ATTR_SUPPORTED_PROTOCOLS
 Os protocolos com suporte com uma credencial específica.

[out] Buffer

Ponteiro para um buffer que recebe os atributos solicitados. Aloque memória para esse buffer usando a função AllocateClientBuffer para que o chamador possa liberá-lo chamando a função FreeContextBuffer .

Retornar valor

Se a função for bem-sucedida, retorne STATUS_SUCCESS.

Se a função falhar, retorne um código NTSTATUS que indica o motivo pelo qual ela falhou. A seguir, lista os motivos comuns de falha e os códigos de erro que a função deve retornar.

Código de retorno Descrição
SEC_E_INSUFFICIENT_MEMORY
 Falha na alocação de memória.
SEC_E_INVALID_HANDLE
 O identificador de credencial não é válido.

Comentários

SSP/APs devem implementar a função SpQueryCredentialsAttributes ; no entanto, o nome real fornecido à implementação cabe ao desenvolvedor.

Um ponteiro para a função SpQueryCredentialsAttributes está disponível na estrutura SECPKG_FUNCTION_TABLE recebida da função SpLsaModeInitialize .

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 ntsecpkg.h

Confira também

SECPKG_FUNCTION_TABLE

SpLsaModeInitialize