IBackgroundCopyGroup::GetStatus メソッド (qmgr.h)

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

GetStatus メソッドを使用して、グループの状態を取得します。

構文

HRESULT GetStatus(
  [out] DWORD *pdwStatus,
        DWORD *pdwJobIndex
);

[out] pdwStatus

グループの状態。状態は、次のフラグの 1 つ以上に設定できます。

値	意味
QM_STATUS_GROUP_FOREGROUND	QMGR は、フォアグラウンドでグループをダウンロードしています。
QM_STATUS_GROUP_INCOMPLETE	QMGR は引き続きグループをダウンロードしています。
QM_STATUS_GROUP_SUSPENDED	グループは中断されています。
QM_STATUS_GROUP_ERROR	グループの処理中にエラーが発生しました。

pdwJobIndex

現在進行中のジョブ。インデックスは常に 0 です (グループに含めることができるジョブは 1 つだけです)。

このメソッドは、次の HRESULT 値と他の値を返します。

リターンコード	説明
S_OK	グループの状態を正常に取得しました。