IBackgroundCopyCallback1::OnStatus メソッド (qmgr.h)

[IBackgroundCopyCallback1 は、[要件] セクションで指定されたオペレーティング システムで使用できます。 今後のバージョンでは変更されるか、利用できなくなる場合もあります。 代わりに、 BITS インターフェイスを使用します。

OnStatus メソッドを実装して、グループが完了したとき、またはエラーが発生したときに通知を受け取ります。

構文

HRESULT OnStatus(
  [in] IBackgroundCopyGroup *pGroup,
  [in] IBackgroundCopyJob1  *pJob,
  [in] DWORD                dwFileIndex,
  [in] DWORD                dwStatus,
  [in] DWORD                dwNumOfRetries,
  [in] DWORD                dwWin32Result,
  [in] DWORD                dwTransportResult
);

パラメーター

[in] pGroup

イベントを生成したグループへのインターフェイス ポインター。

[in] pJob

イベントに関連付けられているジョブへのインターフェイス ポインター。イベントがジョブに関連付けられていない場合は NULL 。

[in] dwFileIndex

エラーまたは -1 に関連付けられているファイルのインデックス。 ファイルを取得するには、 IBackgroundCopyJob1::GetFile メソッドを 呼び出します。

[in] dwStatus

グループの状態。 グループの状態が完了しているか (グループ内のすべてのジョブがダウンロードされています)、またはエラーが発生しています。 QM_STATUS_GROUP_ERROR フラグが設定されている場合にエラーが発生しました。 それ以外の場合、グループは完了です。

[in] dwNumOfRetries

エラーが発生した後に QMGR がグループをダウンロードしようとした回数。 QM_STATUS_GROUP_ERROR dwStatus フラグが設定されている場合にのみ有効です。

[in] dwWin32Result

Win32 エラー コード。 QM_STATUS_GROUP_ERROR dwStatus フラグが設定されている場合にのみ有効です。

[in] dwTransportResult

HTTP エラー コード。 QM_STATUS_GROUP_ERROR dwStatus フラグが設定されている場合にのみ有効です。

戻り値

このメソッドは 、S_OKを返す必要があります。それ以外の場合、サービスは、S_OKが返されるまで、このメソッドを呼び出し続けます。 実装が呼び出される間隔は任意です。

要件

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

こちらもご覧ください

IBackgroundCopyCallback1