CAMSchedule::AddAdvisePacket

Creates a new pending notification and adds it to the advise notification list.

DWORD AddAdvisePacket(
const REFERENCE_TIME & time1,
const REFERENCE_TIME & time2,
HANDLE hNotify,
BOOL bPeriodic);

Parameters

  • time1
    Time that the advise should take place.
  • time2
    Period between notifications. (Ignored if bPeriodic is FALSE.)
  • hNotify
    Notification mechanism. Either a semaphore handle (if bPeriodic is TRUE) or an event handle.
  • bPeriodic
    Flag that specifies whether the notification is sent repeatedly, or whether the notification is sent once. This can be one of the following values:
    TRUE This is a periodic timer that will fire every time2 units until canceled.
    FALSE This is a one-shot timer.

Return Values

Returns the advise token if successful, or zero if an error occurred.

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.