BCryptRegisterConfigChangeNotify

[BCryptRegisterConfigChangeNotify is deprecated beginning with Windows 10.]

The BCryptRegisterConfigChangeNotify(PRKEVENT) function creates kernel mode CNG configuration change event handler.

Syntax

NTSTATUS BCryptRegisterConfigChangeNotify(
  [in] HANDLE *phEvent
);

Parameters

[in] phEvent

The address of a PRKEVENT variable that receives the pointer to the event dispatcher object. You use the kernel wait functions, such as WaitForSingleObject, to determine when the event has been signaled. The event is signaled when the CNG configuration has changed.

This handle must be passed to the BCryptUnregisterConfigChangeNotify(PRKEVENT) function to remove the event notification.

Return value

Returns a status code that indicates the success or failure of the function.

Possible return codes include, but are not limited to, the following.

Return code	Description
STATUS_SUCCESS	The function was successful.
STATUS_INVALID_PARAMETER	The phEvent parameter is not valid.
STATUS_NO_MEMORY	A memory allocation failure occurred.

Remarks

The handle returned in the variable pointed to by the phEvent parameter will be signaled when a change to the CNG configuration occurs.

BCryptRegisterConfigChangeNotify(HANDLE*) can be called only in user mode. Code executing in kernel mode must call BCryptRegisterConfigChangeNotify(PRKEVENT). BCryptRegisterConfigChangeNotify(PRKEVENT) can be called only in kernel mode and at PASSIVE_LEVEL IRQL. Code executing in user mode must call BCryptRegisterConfigChangeNotify(HANDLE*).

Requirements

Requirement	Value
Minimum supported client	Windows 10 Build 20348
Minimum supported server	Windows 10 Build 20348
Header	bcrypt.h

See also

BCryptUnregisterConfigChangeNotify(PRKEVENT) function