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


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