BCryptRegisterConfigChangeNotify

[BCryptRegisterConfigChangeNotify 从 Windows 10 开始弃用。]

BCryptRegisterConfigChangeNotify(PRKEVENT) 函数创建内核模式 CNG 配置更改事件处理程序。

Syntax

NTSTATUS BCryptRegisterConfigChangeNotify(
  [in] HANDLE *phEvent
);

参数

[in] phEvent

PRKEVENT 变量的地址,该变量接收指向事件调度程序对象的指针。 使用内核等待函数(如 WaitForSingleObject)来确定事件是否已发出信号。 CNG 配置发生更改时,会发出该事件信号。

此句柄必须传递给 BCryptUnregisterConfigChangeNotify(PRKEVENT) 函数才能删除事件通知。

返回值

返回一个状态代码,指示函数的成功或失败。

可能的返回代码包括但不限于以下代码。

返回代码 Description
STATUS_SUCCESS
函数成功。
STATUS_INVALID_PARAMETER
phEvent 参数无效。
STATUS_NO_MEMORY
发生内存分配失败。

注解

当发生对 CNG 配置的更改时, phEvent 参数指向的变量中返回的句柄将发出信号。

BCryptRegisterConfigChangeNotify(HANDLE*) 只能在用户模式下调用。 在内核模式下执行的代码必须调用 BCryptRegisterConfigChangeNotify(PRKEVENT)。 BCryptRegisterConfigChangeNotify(PRKEVENT) 只能在内核模式和 PASSIVE_LEVEL IRQL 中调用。 在用户模式下执行的代码必须调用 BCryptRegisterConfigChangeNotify(HANDLE*)。

要求

Requirement 价值
最低支持的客户端 Windows 10 内部版本 20348
支持的最低服务器 Windows 10 内部版本 20348
Header bcrypt.h
Library bcrypt.lib

另请参阅

BCryptUnregisterConfigChangeNotify(PRKEVENT) 函数