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

BCryptRegisterConfigChangeNotify

  • Статья

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

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

Синтаксис

NTSTATUS BCryptRegisterConfigChangeNotify(
  [in] HANDLE *phEvent
);

Параметры

[in] phEvent

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

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

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

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

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

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

Комментарии

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

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

Требования

Требование Значение
Минимальная версия клиента сборка Windows 10 20348
Минимальная версия сервера сборка Windows 10 20348
Верхняя часть bcrypt.h

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

Функция BCryptUnregisterConfigChangeNotify(PRKEVENT)