ItemSetAlarm()

Sets an alarm for the appointment specified by MessageID. This command fails if the item identified by MessageID is not an appointment or it the appointment is past.

Token ID

AFTKN_ITEM_SET_ALARM or 655

Syntax

VOID ItemSetAlarm(ANSISTRING MessageID; 
                   WORD HoursBefore; 
                   WORD MinutesBefore; 
                   [ANSISTRING ProgramToLaunch])

Parameters

MessageID As ANSISTRING: Unique item identifier, returned by ItemMessageIDFromView().
HoursBefore As WORD: Hours before the appointment to sound the alarm.
MinutesBefore As WORD: Minutes before the appointment to source the alarm.
ProgramToLaunch As ANSISTRING: (Optional) Path and name of a program to launch when the alarm goes off.