Microsoft Windows CE 3.0  

CAMSchedule::AddAdvisePacket

Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

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 bPeriodicis FALSE.)
hNotify
Notification mechanism. Either a semaphore handle (if bPeriodicis 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 time2units until canceled.
FALSE This is a one-shot timer.

Return Values

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