3.2.4.4.12 MoveBeforeCalendar (Opnum 18)

The MoveBeforeCalendar method moves a calendar event before the specified reference event. The caller can choose to control the move depending on whether the current resource policy is affected.

 [id(12), helpstring("method MoveBeforeCalendar")] HRESULT MoveBeforeCalendar(
   [in] BSTR bstrCalendarName,
   [in] BSTR bstrRefCalendarName,
   [in] BOOL bChangeActivePolicy
 );

bstrCalendarName: A string that specifies the name of the calendar event to be moved.

If this parameter is NULL, E_INVALIDARG MUST be returned.

bstrRefCalendarName: A string that specifies the name of a reference calendar event, before which the specified event is to be moved.

If this parameter is NULL, E_INVALIDARG MUST be returned.

bChangeActivePolicy: A Boolean value that specifies whether the configuration changes made by this method call SHOULD change the current active policy, if applicable, of the system.<69>

Value

Meaning

FALSE

0x00000000

The current active policy of the system SHOULD NOT be changed by the method call.

TRUE

0x00000001

If applicable, the current active policy of the system SHOULD be changed by the method call.

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.

0xC1FF0259

WRM_ERR_CAL_UNKNOWN_CALENDAR

The specified calendar event does not exist.

Additional IWRMCalendar interface methods are specified in section 3.2.4.4.