<div class="content"><p>The ModifyCalendar method modifies an existing calendar
event.</p><dl>
<dd>
<div><pre> [id(3), helpstring(&#34;method ModifyCalendar&#34;)] HRESULT ModifyCalendar(
   [in] BSTR bstrCalendarXML,
   [in] BOOL bOverwrite,
   [in] BOOL bChangeActivePolicy
 );
</pre></div>
</dd></dl><p><b>bstrCalendarXML: </b>A string that specifies the
calendar event, in the form of a <a href="c7483312-afa9-4c74-a428-65dd1b96bfa5" data-linktype="relative-path">Calendar</a> element (section
2.2.5.7).</p><dl>
<dd>
<p>If this parameter is NULL, <b>E_INVALIDARG</b> MUST
be returned.</p>
</dd></dl><p><b>bOverwrite: </b>A Boolean value that specifies
whether to ignore the timestamp of the specified calendar event when
validating. </p><dl>
<dd>
<p>A timestamp MUST be defined inside a common node at
the root level of an <a href="e371cc74-bf4c-4870-8afe-5062cc628b4f#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85" data-linktype="relative-path">XML</a>
element, as shown in the <a href="1fd26c60-e8c3-432c-805a-48fa5407ea34" data-linktype="relative-path">Calendar</a>
example (section 4.2.6). The format of a timestamp is specified in section <a href="cee8ad39-3c17-48ef-8196-0ec67d7cc4a0" data-linktype="relative-path">2.2.1.4</a>.</p>
</dd>
<dd>
<table><thead>
  <tr>
   <th>
   <p>Value</p>
   </th>
   <th>
   <p>Meaning</p>
   </th>
  </tr>
 </thead><tbody><tr>
  <td>
  <p>FALSE</p>
  <p>0x00000000</p>
  </td>
  <td>
  <p>The timestamp of the new calendar event MUST specify a
  time that is later than or equal to the timestamp of any modifications made
  to a calendar or schedule object on the server. Otherwise, the modification
  SHOULD fail, and <b>WRM_ERR_OLD_INFORMATION</b> SHOULD be returned.</p>
  </td>
 </tr><tr>
  <td>
  <p>TRUE</p>
  <p>0x00000001</p>
  </td>
  <td>
  <p>The calendar event is validated and modified without
  checking the timestamp.</p>
  </td>
 </tr></tbody></table>
</dd></dl><p><b>bChangeActivePolicy: </b>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.<a id="Appendix_A_Target_59"></a><a aria-label="Product behavior note 59" href="1af5b971-a682-44a0-affe-c98947d5e7f7#Appendix_A_59" data-linktype="relative-path">&lt;59&gt;</a></p><dl>
<dd>
<table><thead>
  <tr>
   <th>
   <p>Value</p>
   </th>
   <th>
   <p>Meaning</p>
   </th>
  </tr>
 </thead><tbody><tr>
  <td>
  <p>FALSE</p>
  <p>0x00000000</p>
  </td>
  <td>
  <p>The current active policy of the system SHOULD NOT be
  changed by the method call.</p>
  </td>
 </tr><tr>
  <td>
  <p>TRUE</p>
  <p>0x00000001</p>
  </td>
  <td>
  <p>If applicable, the current active policy of the system
  SHOULD be changed by the method call.</p>
  </td>
 </tr></tbody></table>
</dd></dl><p><b>Return Values: </b>This method returns 0x00000000
for success or a negative <a href="e371cc74-bf4c-4870-8afe-5062cc628b4f#gt_799103ab-b3cb-4eab-8c55-322821b2b235" data-linktype="relative-path">HRESULT</a>
value (in the following table or in <a href="../ms-erref/1bc92ddf-b79e-413c-bbaa-99a5281a6c90" data-linktype="relative-path">[MS-ERREF]</a>
section <a href="../ms-erref/705fb797-2175-4a90-b5a3-3918024b10b8" data-linktype="relative-path">2.1.1</a>)
if an error occurs.</p><dl>
<dd>
<table><thead>
  <tr>
   <th>
   <p>Return value/code</p>
   </th>
   <th>
   <p>Description</p>
   </th>
  </tr>
 </thead><tbody><tr>
  <td>
  <p>0x00000000</p>
  <p>S_OK</p>
  </td>
  <td>
  <p>Operation successful.</p>
  </td>
 </tr><tr>
  <td>
  <p>0x80070057</p>
  <p>E_INVALIDARG</p>
  </td>
  <td>
  <p>One or more arguments are invalid.</p>
  </td>
 </tr><tr>
  <td>
  <p>0xC1FF0069</p>
  <p>WRM_ERR_OLD_INFORMATION</p>
  </td>
  <td>
  <p>The XML timestamp is out of date.</p>
  </td>
 </tr><tr>
  <td>
  <p>0xC1FF0070</p>
  <p>WRM_ERR_TAGS_NOT_IN_ORDER</p>
  </td>
  <td>
  <p>The XML data that is maintained by the <a href="e371cc74-bf4c-4870-8afe-5062cc628b4f#gt_1517eb9b-d2b2-48f0-bf23-bde76923ed30" data-linktype="relative-path">management service</a> is
  invalid or cannot be processed.<a id="Appendix_A_Target_60"></a><a aria-label="Product behavior note 60" href="1af5b971-a682-44a0-affe-c98947d5e7f7#Appendix_A_60" data-linktype="relative-path">&lt;60&gt;</a></p>
  </td>
 </tr><tr>
  <td>
  <p>0xC1FF0260</p>
  <p>WRM_ERR_CAL_INTERVAL_TOO_LONG</p>
  </td>
  <td>
  <p>The calendar recurrence interval value MUST be from 1
  to 999.</p>
  </td>
 </tr><tr>
  <td>
  <p>0xC1FF0263</p>
  <p>WRM_ERR_CAL_INVALID_MONTH</p>
  </td>
  <td>
  <p>The month value MUST be from 1 to 12.</p>
  </td>
 </tr><tr>
  <td>
  <p>0xC1FF0264</p>
  <p>WRM_ERR_CAL_INVALID_MONTHDAY</p>
  </td>
  <td>
  <p>The days of the month MUST have a value from 1 to 31.</p>
  </td>
 </tr><tr>
  <td>
  <p>0xC1FF0265</p>
  <p>WRM_ERR_CAL_INVALID_YEARDAY</p>
  </td>
  <td>
  <p>The day of the year cannot be zero and SHOULD NOT
  exceed the number of days in the selected year.<a id="Appendix_A_Target_61"></a><a aria-label="Product behavior note 61" href="1af5b971-a682-44a0-affe-c98947d5e7f7#Appendix_A_61" data-linktype="relative-path">&lt;61&gt;</a></p>
  </td>
 </tr><tr>
  <td>
  <p>0xC1FF0266</p>
  <p>WRM_ERR_CAL_INVALID_WEEKNO</p>
  </td>
  <td>
  <p>The weeks of the year MUST have a value from 1 to 53.</p>
  </td>
 </tr><tr>
  <td>
  <p>0xC1FF0267</p>
  <p>WRM_ERR_CAL_INVALID_SETPOS</p>
  </td>
  <td>
  <p>The value of the monthly instance of a day of the week
  is invalid.</p>
  </td>
 </tr><tr>
  <td>
  <p>0xC1FF0269</p>
  <p>WRM_ERR_CAL_SCHEDULE_NAME_INVALID</p>
  </td>
  <td>
  <p>The specified schedule name does not exist.</p>
  </td>
 </tr><tr>
  <td>
  <p>0xC1FF0275</p>
  <p>WRM_ERR_CAL_INVALID_DURATION</p>
  </td>
  <td>
  <p>The specified calendar event duration is invalid.
  Specify a duration using the format dd:hh:mm.</p>
  </td>
 </tr></tbody></table>
</dd></dl><p>Additional <a href="b573c233-e3b6-4179-896f-90a4eb0ca8ff" data-linktype="relative-path">IWRMCalendar</a> interface
methods are specified in section 3.2.4.4.</p></div>