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 |
こちらもご覧ください
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示