CmGetCallbackVersion function

The CmGetCallbackVersion routine retrieves the major and minor version numbers for the current version of the configuration manager's registry callback feature.


VOID CmGetCallbackVersion(
  _Out_opt_ PULONG Major,
  _Out_opt_ PULONG Minor



A pointer to a location that receives the major version number.


A pointer to a location that receives the minor version number.

Return Value



The CmGetCallbackVersion routine is available starting with Windows Vista.

For Windows Vista, the major version number is 1 and the minor version number is 0.

Starting with Windows 7, the major version number is 1 and the minor version number is 1.

Version 1.1 contains two changes from version 1.0.

First, in version 1.0, if multiple registry filter drivers are active on the computer at the same time, the REG_POST_XXX_KEY_INFORMATION structure passed to a driver's registry callback routine during the post-notification phase for a create-key or open-key operation might contain a non-NULL Object member, even though the operation failed and the Status member contains an error status. In version 1.1, the Object member is always NULL if the Status member is set to an error status value to indicate that the operation failed.

Second, in version 1.0, an uncaught exception in a registry callback routine is quietly accepted by the operating system. In version 1.1, this exception causes the computer to bug check.

For more information on the differences between versions, see Filtering Registry Calls.


Windows version Available starting with Windows Vista. Available starting with Windows Vista.
Target Platform Universal
Header wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe

See Also





Send comments about this topic to Microsoft