IBackgroundCopyManager::GetJob メソッド

転送キューから指定したジョブを取得します。 通常、アプリケーションはジョブ識別子を保持するため、後でキューからジョブを取得できます。

構文

HRESULT GetJob(
  [in]  REFGUID            JobID,
  [out] IBackgroundCopyJob **ppJob
);

パラメーター

JobID [in]

転送キューから取得するジョブを識別します。 CreateJob メソッドは、ジョブ識別子を返します。

ppJob [out]

JobID で指定されたジョブへの IBackgroundCopyJob インターフェイス ポインター。 完了したら、 ppJob をリリースします

戻り値

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

リターン コード 説明
S_OK
ジョブが転送キューから正常に取得されました。
DO_E_NOT_FOUND
ジョブがキューに見つかりませんでした。
E_ACCESSDENIED
ユーザーには、ジョブを取得するアクセス許可がありません。

必要条件

要件
サポートされている最小のクライアント
Windows 10、バージョン 1709 [デスクトップ アプリのみ]
サポートされている最小のサーバー
Windows Server バージョン 1709 [デスクトップ アプリのみ]
ヘッダー
Deliveryoptimization.h
IDL
DeliveryOptimization.idl
ライブラリ
Dosvc.lib
[DLL]
Dosvc.dll
IID
IID_IBackgroundCopyManagerは 5CE34C0D-0DC9-4C1F-897C-DAA1B78CEE7C として定義されます

関連項目

IBackgroundCopyManager

IBackgroundCopyJob

IBackgroundCopyJob::GetId

IBackgroundCopyManager::CreateJob