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.
Availablility
pmdctl |
Examples
Example 125. C: Minimal scheduler.adjust
CFDateRef myDate = NULL; CFStringRef myTriggerID = NULL; ... CFMutableDictionaryRef myRequest = PMRequestCreateWithParameters(kCFAllocatorDefault, kPMRPCSchedulerAdjust, kPMRPCParameterDate, myDate, kPMRPCParameterTriggerID, myTriggerID, nil);