IBackgroundCopyJob::SetPriority メソッド (bits.h)

  • [アーティクル]

ジョブの優先度レベルを指定します。 優先度レベルは、転送キュー内の他のジョブに対してジョブが処理されるタイミングを決定します。

構文

HRESULT SetPriority(
  [in] BG_JOB_PRIORITY Val
);

パラメーター

[in] Val

転送キュー内の他のジョブに対するジョブの優先順位を指定します。 既定値は BG_JOB_PRIORITY_NORMAL です。 優先度レベルの一覧については、 BG_JOB_PRIORITY 列挙を参照してください。

戻り値

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

リターン コード 説明
S_OK
 ジョブの優先順位が正常に設定されました。
E_NOTIMPL
 Priority の値は、BG_JOB_PRIORITY列挙では定義されていません。
BG_E_INVALID_STATE
 ジョブの状態をBG_JOB_STATE_CANCELLEDまたはBG_JOB_STATE_ACKNOWLEDGEDすることはできません。

要件

要件 値
サポートされている最小のクライアント Windows XP
サポートされている最小のサーバー Windows Server 2003
対象プラットフォーム Windows
ヘッダー bits.h
Library Bits.lib
[DLL] QmgrPrxy.dll

こちらもご覧ください

BG_JOB_PRIORITY

IBackgroundCopyJob::GetPriority