REGISTRYNOTIFYCALLBACK Structure

Windows Mobile 6.5
A version of this page is also available for
4/8/2010

This structure is used to prototype a function to pass to RegistryNotifyCallback to call back the client when a registry value changes.


typedef void REGISTRYNOTIFYCALLBACK(
  HREGNOTIFY hNotify,
  DWORD dwUserData,
  const PBYTE pData,
  const UINT cbData
);

hNotify

The valid HREGNOTIFY handle returned from RegistryNotifyCallback.

dwUserData

User data passed back to the client with the notification.

pData

A pointer to the new value for the key value, this will be set to NULL if the value was deleted.

cbData

The number of bytes to pointed to by pData, this value will be set to 0 if the value was deleted.

A callback matching this prototype is used to notify clients that registered for notifications using RegistryNotifyCallback.

To stop notification and to close the notification handle, it is safer to use RegistryCloseNotification from within the callback. However, this type of notification is transient. Resetting the device stops the notification.

All notifications happen synchronously, so it is important to not block notifications while executing this callback.

Headerregext.h
Windows Embedded CEWindows Embedded CE 6.0 and later
Windows MobileWindows Mobile Version 5.0 and later

Community Additions

Show: