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

Статья
11/20/2024

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

Синтаксис

BOOL CredDeleteA(
  [in] LPCSTR TargetName,
  [in] DWORD  Type,
  [in] DWORD  Flags
);

Параметры

[in] TargetName

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

[in] Type

Тип учетных данных для удаления. Должен быть одним из определенных типов CRED_TYPE_*. Список определенных типов см. в элементе Type структуры CREDENTIAL.

Если значение этого параметра CRED_TYPE_DOMAIN_EXTENDED, эта функция может удалить учетные данные, указывающие имя пользователя при наличии нескольких учетных данных для одного целевого объекта. Значение параметра TargetName должно указать имя пользователя в качестве Target|UserName.

[in] Flags

Зарезервировано и должно быть равно нулю.

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

Функция возвращает TRUE при успешном выполнении и false при сбое. Функцию getLastError можно вызвать , чтобы получить более конкретный код состояния. Можно вернуть следующие коды состояния:

ERROR_NOT_FOUND
Учетные данные с указанным TargetNameотсутствуют.
ERROR_NO_SUCH_LOGON_SESSION
Сеанс входа не существует или нет набора учетных данных, связанных с этим сеансом входа. Сеансы входа в сеть не имеют связанного набора учетных данных.
ERROR_INVALID_FLAGS
Недопустимый флаг был указан для параметра Flags.

Замечания

Заметка

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

Требования

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

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