Функция 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 |