BCryptRegisterConfigChangeNotify 函数 (bcrypt.h)

[BCryptRegisterConfigChangeNotify 已从 Windows 10 开始弃用。]

BCryptRegisterConfigChangeNotify (HANDLE*) 函数创建用户模式 CNG 配置更改事件处理程序。

语法

NTSTATUS BCryptRegisterConfigChangeNotify(
  [out] PRKEVENT pEvent
);

[out] pEvent

接收事件句柄的 HANDLE 变量的地址。使用 Wait 函数之一（例如 WaitForSingleObject）确定事件已发出信号。事件未命名，必须是手动重置事件。当任何 CNG 配置数据发生更改时，将发出事件信号。

此句柄必须传递给 BCryptUnregisterConfigChangeNotify (HANDLE) 函数，以删除事件通知。

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

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

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

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