3.2.4.4.8 CreateSchedule (Opnum 14)

The CreateSchedule method creates a new schedule object.

 [id(8), helpstring("method CreateSchedule")] HRESULT CreateSchedule(
   [in] BSTR bstrScheduleXML
 );

bstrScheduleXML: A string that specifies the new schedule, in the form of a Schedule element (section 2.2.5.26). Sample XML is provided in Schedule Example (section 4.2.22).

If this parameter is NULL, E_INVALIDARG MUST be returned.

Return Values: This method returns 0x00000000 for success or a negative HRESULT value (in the following table or in [MS-ERREF] section 2.1.1) if an error occurs.

Return value/code

Description

0x00000000

S_OK

Operation successful.

0x80070057

E_INVALIDARG

One or more arguments are invalid.

0xC1FF0070

WRM_ERR_TAGS_NOT_IN_ORDER

The XML data that is maintained by the management service is invalid or cannot be processed.<64>

0xC1FF025C

WRM_ERR_CAL_MAX_SCHED_EXCEEDED

The number of schedules has exceeded an implementation-defined limit.<65>

0xC1FF0270

WRM_ERR_CAL_DUPLICATE_SCHEDULE

The specified schedule object already exists.

Additional IWRMCalendar interface methods are specified in section 3.2.4.4.