Функция CredFindBestCredentialA (wincred.h)

Статья
11/20/2024

Функция CredFindBestCredential выполняет поиск базы данных управления учетными данными (CredMan) для набора универсальных учетных данных, связанных с текущим сеансом входа и наиболее подходящим для указанного целевого ресурса.

Синтаксис

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

Параметры

[in] TargetName

Указатель на строку, завершающую значение NULL, содержащую имя целевого ресурса, для которого нужно найти учетные данные.

[in] Type

Тип учетных данных для поиска. В настоящее время эта функция поддерживает только CRED_TYPE_GENERIC.

[in] Flags

Скрытный.

[out] Credential

Адрес указателя на структуру CREDENTIAL, указывающую набор учетных данных, который находит эту функцию.

После завершения работы с этой структурой освободите ее, вызвав функцию CredFree.

Возвращаемое значение

Если функция выполнена успешно, она возвращает TRUE.

Если функция завершается ошибкой, она возвращает FALSE. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError.

Замечания

Заметка

Заголовок wincred.h определяет CredFindBestCredential как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Vista [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2008 [только классические приложения]
целевая платформа	Виндоус
заголовка	wincred.h
библиотеки	Advapi32.lib
DLL	Advapi32.dll

Поделиться через