CmGetCallbackVersion routine

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_opt_  PULONG Major,
  _Out_opt_  PULONG Minor
);

Parameters

Major [out, optional]

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

Minor [out, optional]

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

Version

Available starting with Windows Vista.

Header

Wdm.h (include Wdm.h, Ntddk.h, or Ntifs.h)

Library

Ntoskrnl.lib

IRQL

<= APC_LEVEL

See also

REG_POST_CREATE_KEY_INFORMATION
REG_POST_OPEN_KEY_INFORMATION
ZwCreateKey
ZwOpenKey

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft