IUpdate::CopyFromCache メソッド (wuapi.h)

  • [アーティクル]

更新プログラムの内容を指定したパスにコピーします。

構文

HRESULT CopyFromCache(
  [in] BSTR         path,
  [in] VARIANT_BOOL toExtractCabFiles
);

パラメーター

[in] path

更新内容をコピーする場所のパス。

[in] toExtractCabFiles

将来利用するために予約されています。

[ExtractCabFiles] を[VARIANT_TRUE] または [VARIANT_FALSE] に設定する必要があります。

戻り値

成功した場合 は、S_OK を返します。 それ以外の場合は、COM または Windows エラー コードを返します。

このメソッドは、次のエラー コードを返すこともできます。

リターン コード 説明
E_ACCESSDENIED
 このメソッドは、リモート コンピューターから呼び出すことはできません。
E_INVALIDARG
 パラメーター値が無効です。
WU_E_INVALID_OPERATION
 コンピューターが更新サイトにアクセスできませんでした。

(このメソッドは、インターフェイスを実装しているオブジェクトがロックダウンされている場合は、 WU_E_INVALID_OPERATION を返します。
WU_E_EULAS_DECLINED
 Microsoft ソフトウェア ライセンス条項は受け入れられません。
WU_E_DM_NOTDOWNLOADED
 ファイルはダウンロードされません。
WU_E_DM_INCORRECTFILEHASH
 ファイル ハッシュの検証に失敗しました。
COR_E_DIRECTORYNOTFOUND
 ファイルまたはディレクトリが見つかりませんでした。
STG_E_PATHNOTFOUND
 ファイルまたはディレクトリが見つかりませんでした。

解説

バンドルされた更新プログラムをコピーするには、この更新プログラムにバンドルされている個々の更新プログラムでこのメソッドを呼び出します。

メモ ダウンロードした更新プログラムを 1 台のコンピューターから別のコンピューターに移動するために 、IUpdate::CopyFromCache メソッドと IUpdate2::CopyToCache メソッドを使用することはお勧めしません。 Windows Update エージェント (WUA) が更新プログラムをダウンロードすると、特定のクライアント コンピューターに必要な更新プログラムのペイロードの一部のみがダウンロードされる可能性があります。 更新プログラムのペイロードの必要な部分は、多くの場合、コンピューターのハードウェアとソフトウェアの構成が似ている場合でも、コンピューターによって異なる場合があります。 IUpdate2::CopyToCache は、指定されたファイルがそのコンピューターで通常ダウンロードWindows Updateファイルと完全に一致する場合にのみ機能します。IUpdate::CopyFromCache を呼び出して別のコンピューター上のファイルを取得した場合、ファイルは通常ダウンロードWindows Updateファイルと一致しない可能性があるため、IUpdate2::CopyToCache が失敗する可能性があります。
 

要件

   
サポートされている最小のクライアント Windows XP、Windows 2000 Professional sp3 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003、Windows 2000 Server SP3 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー wuapi.h
Library Wuguid.lib
[DLL] Wuapi.dll

関連項目

IUpdate