CmGetCallbackVersion function (wdm.h)

Article
02/22/2024

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

Syntax

void CmGetCallbackVersion(
  [out, optional] PULONG Major,
  [out, optional] PULONG Minor
);

Parameters

[out, optional] Major

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

[out, optional] Minor

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

Return value

None

Remarks

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.

Requirements

Requirement	Value
Minimum supported client	Available starting with Windows Vista.
Target Platform	Universal
Header	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Library	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL