Share via

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

  • Статья

[BCryptRegisterConfigChangeNotify является нерекомендуемой начиная с Windows 10.]

Функция BCryptRegisterConfigChangeNotify(HANDLE*) создает обработчик событий изменения конфигурации CNG в пользовательском режиме.

Синтаксис

NTSTATUS BCryptRegisterConfigChangeNotify(
  [out] PRKEVENT pEvent
);

Параметры

[out] pEvent

Адрес переменной HANDLE , которая получает дескриптор события. Используйте одну из функций ожидания, например WaitForSingleObject, чтобы определить, когда событие было показано. Событие не называется и должно быть событием сброса вручную. Событие подается при изменении любых данных конфигурации CNG.

Этот дескриптор необходимо передать в функцию BCryptUnregisterConfigChangeNotify(HANDLE), чтобы удалить уведомление о событии.

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

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

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

Код возврата Описание
STATUS_SUCCESS
 Функция выполнена успешно.
STATUS_INVALID_PARAMETER
 Недопустимый параметр phEvent .
STATUS_NO_MEMORY
 Произошел сбой выделения памяти.

Комментарии

Дескриптор, возвращенный в переменной, на которую указывает параметр phEvent , будет сигнализировать при изменении конфигурации CNG.

BCryptRegisterConfigChangeNotify(HANDLE*) можно вызывать только в пользовательском режиме. Код, выполняемый в режиме ядра, должен вызывать BCryptRegisterConfigChangeNotify(PRKEVENT).

Требования

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

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

BCryptUnregisterConfigChangeNotify(HANDLE)