IBackgroundCopyError インターフェイス (bits.h)

画面右側の
IBackgroundCopyError インターフェイスを使用して、エラーの原因と転送プロセスを続行できるかどうかを判断します。

BITS は、ジョブの状態がBG_JOB_STATE_ERRORまたはBG_JOB_STATE_TRANSIENT_ERRORである場合にのみ、エラー オブジェクトを作成します。 IBackgroundCopyXXXX インターフェイス メソッドが失敗しても、BITS はエラー オブジェクトを作成しません。 エラー オブジェクトは、BITS がジョブのデータの転送を開始するまで (ジョブの状態がBG_JOB_STATE_TRANSFERRINGに変わる)、またはアプリケーションが終了するまで使用できます。

IBackgroundCopyError オブジェクトを取得するには、IBackgroundCopyJob::GetError メソッドを呼び出します。

継承

IBackgroundCopyError インターフェイスは、IUnknown インターフェイスから継承されます。 IBackgroundCopyError には、次の種類のメンバーもあります。

メソッド

IBackgroundCopyError インターフェイスには、これらのメソッドがあります。

IBackgroundCopyError::GetError エラー コードを取得し、エラーが発生したコンテキストを識別します。
IBackgroundCopyError::GetErrorContextDescription エラーが発生したコンテキストの説明を取得します。
IBackgroundCopyError::GetErrorDescription エラーに関連付けられているエラー テキストを取得します。
IBackgroundCopyError::GetFile エラーに関連付けられているファイル オブジェクトへのインターフェイス ポインターを取得します。
IBackgroundCopyError::GetProtocol ファイルの転送に使用するプロトコルを取得します。 リモート ファイル名は、ファイルの転送に使用するプロトコルを識別します。

要件

サポートされている最小のクライアント	Windows XP
サポートされている最小のサーバー	Windows Server 2003
対象プラットフォーム	Windows
ヘッダー	bits.h

関連項目

BG_JOB_STATE

IBackgroundCopyCallback::JobError

IBackgroundCopyJob::GetError

IBackgroundCopyJob::GetState

IBackgroundCopyManager::GetErrorDescription