Export (0) Print
Expand All

RegistryBatchNotification

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

This function sets the batch time for transient notification requests.


HRESULT WINAPI RegistryBatchNotificaton(
  HREGNOTIFY hNotify,
  DWORD dwMillisecondsIdle,
  DWORD dwMillesecondsMax
);

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.

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.

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

Headerregext.h
Libraryaygshell.lib
Windows Embedded CEWindows Embedded CE 6.0 and later
Windows MobilePocket PC for Windows Mobile Version 5.0 and later, Smartphone for Windows Mobile Version 5.0 and later

Community Additions

ADD
Show:
© 2014 Microsoft