Função CredFindBestCredentialA (wincred.h)

Artigo
11/20/2024

A função CredFindBestCredential pesquisa o banco de dados CredMan ( de Gerenciamento de Credenciais) para o conjunto de credenciais genéricas associadas à sessão de logon atual e que melhor correspondem ao recurso de destino especificado.

Sintaxe

BOOL CredFindBestCredentialA(
  [in]  LPCSTR       TargetName,
  [in]  DWORD        Type,
  [in]  DWORD        Flags,
  [out] PCREDENTIALA *Credential
);

Parâmetros

[in] TargetName

Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome do recurso de destino para o qual encontrar credenciais.

[in] Type

O tipo de credenciais a serem pesquisadas. Atualmente, essa função dá suporte apenas a CRED_TYPE_GENERIC.

[in] Flags

Reservado.

[out] Credential

O endereço de um ponteiro para uma estrutura de CREDENTIAL que especifica o conjunto de credenciais que essa função encontra.

Quando terminar de usar essa estrutura, libere-a chamando a função CredFree.

Valor de retorno

Se a função for bem-sucedida, ela retornará VERDADEIRO.

Se a função falhar, ela retornará FALSE . Para obter informações de erro estendidas, chame GetLastError.

Observações

Nota

O cabeçalho wincred.h define CredFindBestCredential 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 Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2008 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	wincred.h
biblioteca	Advapi32.lib
de DLL	Advapi32.dll

Compartilhar via