Name
adjust, scheduler.adjust, kPMRPCSchedulerAdjust — Adjust a pending trigger date.
Synopsis
void scheduler.adjust( |
trigger ID, |
|
| |
date); |
|
trigger ID : string, length 1..255;
date : date;
Description
Adjust a pending trigger date.
adjust replaces a pending trigger's date and time.
adjust provides the ability to move a queued trigger's date and time forward or backward in time. Use adjust to offer flexible schedules.
The provided date must be in the future. If the provided trigger ID does not match an existing queued trigger ID, no change occurs.
Parameters
trigger ID. Trigger ID of a queued trigger. trigger ID is a string. trigger ID must be between 1 and 255 characters long, inclusive.
date. Date to set the queued trigger to fire. date is a date.
Security
adjust can be requested by any authenticated client.
Unauthenticated clients are authorized using the uk.co.dssw.powermanager.scheduler.adjust right. By default, only local processes belonging to administrator can send a adjust request.
Examples
Example 119. C: Minimal scheduler.adjust
CFDateRef myDate = NULL;
CFStringRef myTriggerID = NULL;
...
CFMutableDictionaryRef myRequest = PMRequestCreateWithParameters(kCFAllocatorDefault, kPMRPCSchedulerAdjust, kPMRPCParameterDate, myDate, kPMRPCParameterTriggerID, myTriggerID, nil);