[BCryptRegisterConfigChangeNotify 从 Windows 10 开始弃用。]
BCryptRegisterConfigChangeNotify(PRKEVENT) 函数创建内核模式 CNG 配置更改事件处理程序。
Syntax
NTSTATUS BCryptRegisterConfigChangeNotify(
[in] HANDLE *phEvent
);
参数
[in] phEvent
PRKEVENT 变量的地址,该变量接收指向事件调度程序对象的指针。 使用内核等待函数(如 WaitForSingleObject)来确定事件是否已发出信号。 CNG 配置发生更改时,会发出该事件信号。
此句柄必须传递给 BCryptUnregisterConfigChangeNotify(PRKEVENT) 函数才能删除事件通知。
返回值
返回一个状态代码,指示函数的成功或失败。
可能的返回代码包括但不限于以下代码。
| 返回代码 | Description |
|---|---|
|
函数成功。 |
|
phEvent 参数无效。 |
|
发生内存分配失败。 |
注解
当发生对 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 |