Функция BCryptDeographySecret (bcrypt.h)

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

Синтаксис

NTSTATUS BCryptDestroySecret(
  [in] BCRYPT_SECRET_HANDLE hSecret
);

Параметры

[in] hSecret

BCRYPT_SECRET_HANDLE быть уничтожены.

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

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

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

Код возврата	Описание
STATUS_SUCCESS	Функция выполнена успешно.
STATUS_INVALID_HANDLE	Дескриптор в параметре hSecret недопустим.

Комментарии

В зависимости от того, какие режимы процессора поддерживает поставщик, BCryptDehostSecret можно вызывать из пользовательского режима или режима ядра. Вызывающие функции режима ядра могут выполняться в PASSIVE_LEVELIRQL или DISPATCH_LEVEL IRQL. Если текущий уровень IRQL DISPATCH_LEVEL, дескриптор, указанный в параметре hSecret , должен быть производным от дескриптора алгоритма, возвращенного поставщиком, который был открыт с помощью флага BCRYPT_PROV_DISPATCH .

Чтобы вызвать эту функцию в режиме ядра, используйте Cng.lib, который входит в состав пакета средств разработки драйверов (DDK). Windows Server 2008 и Windows Vista: Чтобы вызвать эту функцию в режиме ядра, используйте Ksecdd.lib.

Требования

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

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

BCryptSecretAgreement