Exchange における EWS での同期に関連するエラーの処理
Exchange の EWS マネージ API または EWS を使用して開発したアプリケーションの同期に関連するエラーを処理する方法を説明します。
アプリケーションがアイテムとフォルダーを同期する場合は、同期に関連するエラーを処理する必要があります。 これらのエラーは実行時、または EWS アプリケーションを開発するときに処理することができます。 これらのエラーのほとんどは、EWS マネージ API では ResponseCodeType 列挙体で、Exchange Web サービス (EWS) では ResponseCode 要素で定義されています。
表 1. 同期に関連するエラーと、それらを処理する方法
| エラー | 発生するタイミング | 処理方法 |
|---|---|---|
| ErrorInvalidSyncStateData |
無効な同期状態の値を使用してアイテムまたはフォルダーを同期するとき。 後続の要求にルート フォルダーが含まれている場合に、最初の SyncFolderHierarchy 要求でルート フォルダーを除外したとき。 後続の要求で別のルート フォルダーを使用したとき。 |
送信している同期状態の値が、以前の同期の際に戻された同期状態の値と一致していることを確認します。 アイテムを同期するときにフォルダー階層の同期状態を送信していないことを確認します (その逆に、フォルダー階層を同期する場合にアイテムの同期状態を送信していないことも確認します)。 適切なルート フォルダーの同期状態を送信していることを確認します。 各要求で同じルート フォルダーが指定されていることを確認します。 以前の要求で null のルート フォルダーが指定されていないこと、現在の要求にルートのルート フォルダーが含まれていることを確認します。 null とルートは同じものとして扱われません。 |
| ErrorSyncFolderNotFound |
サーバ―上にないフォルダーのサブフォルダーまたはアイテムを同期するとき。 |
要求で指定したフォルダー ID が、以前の同期応答でサーバーから返されたフォルダー ID と一致することを確認します。 |
| ErrorTimeoutExpired |
送信した要求数が多すぎるとき。 |
調整されることを避けるため、バッチ処理あたりのアイテム数を 10 に制限します。 |
| ServiceResponseException |
サーバーがオフラインまたは接続に問題がある場合に、EWS に接続するとき。 |
サーバーとの接続をチェックし、要求を後ほど再試行します。 これは、一時的なサービス エラーまたはネットワーク エラーの可能性があります。 |