Функция NCryptDeleteKey (ncrypt.h)

Функция NCryptDeleteKey удаляет ключ CNG.

Синтаксис

SECURITY_STATUS NCryptDeleteKey(
  [in] NCRYPT_KEY_HANDLE hKey,
  [in] DWORD             dwFlags
);

Параметры

[in] hKey

Дескриптор удаляемого ключа. Этот дескриптор получен с помощью функции NCryptOpenKey .

Примечание Функция NCryptDeleteKey удаляет ключ и освобождает дескриптор. Приложения могут использовать функцию NCryptFreeObject для освобождения дескриптора в случае сбоя NCryptDeleteKey .

 

[in] dwFlags

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

Значение	Значение
NCRYPT_SILENT_FLAG	Запрашивает, чтобы поставщик служб ключей (KSP) не отображал пользовательский интерфейс. Если поставщик должен отобразить пользовательский интерфейс для работы, вызов завершается ошибкой и KSP должен задать код ошибки NTE_SILENT_CONTEXT в качестве последней ошибки.

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

Возвращает код состояния, указывающий на успешное или неудачное выполнение функции.

Возможные коды возврата включают, помимо прочего, следующие.

Код возврата	Описание
ERROR_SUCCESS	Функция выполнена успешно.
NTE_BAD_FLAGS	Параметр dwFlags содержит недопустимое значение.
NTE_INVALID_HANDLE	Недопустимый параметр hKey .

Комментарии

Служба не должна вызывать эту функцию из функции StartService. Если служба вызывает эту функцию из функции StartService, может возникнуть взаимоблокировка, и служба может перестать отвечать на запросы.

Требования

Минимальная версия клиента	Windows Vista [классические приложения | Приложения UWP]
Минимальная версия сервера	Windows Server 2008 [классические приложения | Приложения UWP]
Целевая платформа	Windows
Header	ncrypt.h
Библиотека	Ncrypt.lib
DLL	Ncrypt.dll

См. также раздел

NCryptOpenKey