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

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

  • Статья

Функция 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 [только классические приложения]
Целевая платформа Windows
Header wincred.h
Библиотека Advapi32.lib
DLL Advapi32.dll