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) 。