RegistryBatchNotification
This function sets the batch time for transient notification requests.
HRESULT WINAPI RegistryBatchNotificaton(
HREGNOTIFY hNotify,
DWORD dwMillisecondsIdle,
DWORD dwMillesecondsMax
);
Parameters
- hNotify
[in] Handle to a change notification request returned by RegistryNotifyWindow, RegistryNotifyCallback, or RegistryNotifyMsgQueue. - dwMillisecondsIdle
[in] Number of milliseconds that the value must be constant before notifications are sent. Notifications are sent only if a change in registry value occurs. - dwMillesecondsMax
[in] Maximum number of milliseconds between the time the first change happens and the notification event.
Return Values
The following table shows the return values for this function.
| Value | Description |
|---|---|
| S_OK | Batch times for the specified notification request are changed. |
| E_INVALIDARG | Invalid hNotify or dwMillisecondsIdle is set to INFINITE. |
Remarks
Success indicates that new batch times are set. Failure does not cause any change.
You can use this function to track registry values that change frequently.
Whenever a specified value changes, the notification system waits for dwMillisecondsIdle before sending a notification. If the value changes during the waiting period, the notification system resets the timer to wait for another dwMillisecondsIdle. To prevent the notification system from waiting indefinitely, dwMillesecondsMax sets the limit for the waiting period. The dwMillesecondsMax value sets the maximum time period from the time the first notification arrives to the time the notification is sent. You can set dwMillesecondsMax to INFINITE to allow notifications to wait until the specified value is idle. However, you cannot set dwMillisecondsIdle to INFINITE
Requirements
Pocket PC: Windows Mobile 5.0 and later.
Smartphone: Windows Mobile 5.0 and later.
OS Versions: Windows CE 5.01 and later.
Header: Regext.h
Link Library: Aygshell.lib
See Also
State and Notifications Broker Functions | State and Notifications Broker Reference | State and Notifications Broker
Send Feedback on this topic to the authors