UpdateItem 操作 (タスク)

  • [アーティクル]

UpdateItem 操作は、Exchange ストアのタスク 項目のプロパティを更新するために使用されます。

注釈

Exchange Web サービスを使用してタスク要求を送信することはできません。 Exchange Web サービスは、MicrosoftOfficeOutlook によって作成されたタスク要求を返すことができます。 タスク要求が既に送信されている場合、タスクを更新する要求によってエラーが返されます。

定期的なタスクの現在の出現箇所の更新

定期的なタスクに対する UpdateItem 操作の結果は、単一の非回復タスクに対する UpdateItem 操作の結果とは異なります。 定期的なタスクの発生に対する変更により、次の更新が行われると、1 回限りのタスクが生成されます。

  1. 再生成または非反復の繰り返しタスクの status プロパティが Completed に設定 されています。

  2. 繰り返し実行されていないタスクの開始日または終了日が変更されます。

たとえば、 UpdateItem 要求で定期的なタスクの Completed 値が true に設定されている場合、 UpdateItemResponse には、新しく作成された 1 回限りのタスクを表す新しい ID と ChangeKey が含まれます。 要求に含まれていた ID は引き続き有効であり、その ID によって表される定期的なタスクが更新され、次に発生する予定が表されます。 定期的なタスクが更新されたため、要求に含まれていた ChangeKey は無効になりました。

GetItem 操作を使用して、定期的なタスクの最新の ChangeKey を取得できます。

非回復タスクの場合、または定期的なタスクが最後に発生した場合、UpdateItem 応答は、それに渡されたのと同じ ID を 返し、関連付けられている更新された ChangeKey を返します。

関連項目

UpdateItem 操作