Edit

BCryptRegisterConfigChangeNotify function (bcrypt.h)

  • Article

[BCryptRegisterConfigChangeNotify is deprecated beginning with Windows 10.]

The BCryptRegisterConfigChangeNotify(HANDLE*) function creates a user mode CNG configuration change event handler.

Syntax

NTSTATUS BCryptRegisterConfigChangeNotify(
  [out] PRKEVENT pEvent
);

Parameters

[out] pEvent

The address of a HANDLE variable that receives the event handle. Use one of the Wait Functions, such as WaitForSingleObject, to determine when the event has been signaled. The event is unnamed and must be a manual-reset event. The event is signaled when any CNG configuration data has changed.

This handle must be passed to the BCryptUnregisterConfigChangeNotify(HANDLE) 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).

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header bcrypt.h
Library Bcrypt.lib
DLL Bcrypt.dll

See also

BCryptUnregisterConfigChangeNotify(HANDLE)