BCryptRegisterConfigChangeNotify 函数 (bcrypt.h)
[BCryptRegisterConfigChangeNotify 已从 Windows 10 开始弃用。]
BCryptRegisterConfigChangeNotify (HANDLE*) 函数创建用户模式 CNG 配置更改事件处理程序。
语法
NTSTATUS BCryptRegisterConfigChangeNotify(
[out] PRKEVENT pEvent
);
参数
[out] pEvent
接收事件句柄的 HANDLE 变量的地址。 使用 Wait 函数之一(例如 WaitForSingleObject)确定事件已发出信号。 事件未命名,必须是手动重置事件。 当任何 CNG 配置数据发生更改时,将发出事件信号。
此句柄必须传递给 BCryptUnregisterConfigChangeNotify (HANDLE) 函数,以删除事件通知。
返回值
返回指示函数成功或失败的状态代码。
可能的返回代码包括但不限于以下内容。
返回代码 | 说明 |
---|---|
|
函数成功。 |
|
phEvent 参数无效。 |
|
内存分配失败。 |
注解
更改 CNG 配置时,将发出 phEvent 参数指向的变量中返回的句柄的信号。
BCryptRegisterConfigChangeNotify (HANDLE*) 只能在用户模式下调用。 在内核模式下执行的代码必须调用 BCryptRegisterConfigChangeNotify (PRKEVENT) 。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
目标平台 | Windows |
标头 | bcrypt.h |
Library | Bcrypt.lib |
DLL | Bcrypt.dll |