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