REGISTRYNOTIFYCALLBACK
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
);
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
OS Versions: Windows CE 5.01 and later.
Header: Regext.h
See Also
RegistryNotifyCallback | State and Notifications Broker Functions | State and Notifications Broker Reference | State and Notifications Broker
Send Feedback on this topic to the authors