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

Статья
11/20/2024

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

Замечания

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

Заметка

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

Требования

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

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