BCryptRegisterConfigChangeNotify

[BCryptRegisterConfigChangeNotify 從 Windows 10 開始已被取代。]

BCryptRegisterConfigChangeNotify (PRKEVENT) 函式會建立核心模式 CNG 組態變更事件處理程式。

語法

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

規格需求

需求	值
最低支援的用戶端	Windows 10 組建 20348
最低支援的伺服器	Windows 10 組建 20348
標頭	bcrypt.h

另請參閱

BCryptUnregisterConfigChangeNotify (PRKEVENT) 函式