CAMSchedule::AddAdvisePacket

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

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

Syntax

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.

  Value	Description
  TRUE	This is a periodic timer that will fire every time2 units until canceled.
  FALSE	This is a one-shot timer.

Return Value

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

Requirements