REGISTRYNOTIFYCALLBACK Structure (Windows Embedded CE 6.0)

1/6/2010

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

Syntax

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

Parameters

• 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.

Remarks

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.

Requirements

See Also

Reference

State and Notifications Broker Structures
RegistryNotifyCallback
State and Notifications Broker Functions
State and Notifications Broker Reference

Other Resources

State and Notifications Broker