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

Функция CredRead считывает учетные данные из набора учетных данных пользователя. Используемый набор учетных данных связан с сеансом входа текущего маркера. Для маркера не должен быть отключен идентификатор безопасности пользователя.

Синтаксис

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

Параметры

[in] TargetName

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

[in] Type

Тип считываемых учетных данных. Тип должен быть одним из типов, определенных CRED_TYPE_*.

[in] Flags

В настоящее время зарезервировано и должно быть равно нулю.

[out] Credential

Указатель на один выделенный буфер блока для возврата учетных данных. Все указатели, содержащиеся в буфере, являются указателями на расположения в пределах одного выделенного блока. Один возвращаемый буфер должен быть освобожден путем вызова CredFree.

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

Функция возвращает значение TRUE при успешном выполнении и FALSE при сбое. Для получения более конкретного кода состояния можно вызвать функцию GetLastError . Можно вернуть следующие коды состояния:

• ERROR_NOT_FOUND

  Учетные данные с указанным targetName отсутствуют.

• ERROR_NO_SUCH_LOGON_SESSION

  Сеанс входа не существует или с этим сеансом входа не связан набор учетных данных. Сеансы сетевого входа не имеют связанных учетных данных.

• ERROR_INVALID_FLAGS

  Для параметра Flags был указан недопустимый флаг.

Комментарии

Если значение элемента Type структуры CREDENTIAL , указанной параметром Credential , CRED_TYPE_DOMAIN_EXTENDED, в целевом имени должно быть указано пространство имен. Эта функция может возвращать только одно удостоверение указанного типа.

Примечание

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

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	wincred.h
Библиотека	Advapi32.lib
DLL	Advapi32.dll