IUpdate2::CopyToCache メソッド (wuapi.h)

  • [アーティクル]

指定したソースの場所から内部Windows Update エージェント (WUA) ダウンロード キャッシュに更新用のファイルをコピーします。

構文

HRESULT CopyToCache(
  [in] IStringCollection *pFiles
);

パラメーター

[in] pFiles

更新プログラムのファイルの完全なパスを含む文字列のコレクションを表す IStringCollection インターフェイス。

文字列は、コピーされるファイルの完全なパスを指定する必要があります。 文字列は、ファイルを含むディレクトリのみを指定することはできません。

戻り値

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

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

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

注釈

インターフェイスを実装しているオブジェクトがロックダウンされている場合、このメソッドは WU_E_INVALID_OPERATION を返します。

メモ ダウンロードした更新プログラムを 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

こちらもご覧ください

IUpdate2