IUpdateInstaller::BeginInstall メソッド (wuapi.h)

  • [アーティクル]

更新プログラムの非同期インストールを開始します。

構文

HRESULT BeginInstall(
  [in]  IUnknown         *onProgressChanged,
  [in]  IUnknown         *onCompleted,
  [in]  VARIANT          state,
  [out] IInstallationJob **retval
);

パラメーター

[in] onProgressChanged

インストールが完了する前に、インストールの進行状況の変更のために定期的に呼び出 される IInstallationProgressChangedCallback インターフェイス。

[in] onCompleted

インストール操作が完了したときに呼び出 される IInstallationCompletedCallback インターフェイス。

[in] state

IInstallationJob インターフェイスの AsyncState プロパティによって返される呼び出し元固有の状態。

[out] retval

開始された非同期インストール操作で使用できるプロパティとメソッドを含む IInstallationJob インターフェイス。

戻り値

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

エラー コード。

リターン コード 説明
S_OK
 更新プログラムの非同期インストールが正常に開始されました。
WU_E_INSTALL_NOT_ALLOWED
 インストーラーが更新プログラムをインストールまたは削除している場合、このメソッドを呼び出すことはできません。

IUpdateInstaller インターフェイスの IsBusy プロパティがVARIANT_FALSEを返す場合にのみ、このメソッドを呼び出します。
WU_E_NO_UPDATE
 Windows Update エージェント (WUA) には、コレクション内の更新プログラムがありません。

解説

スクリプト言語からこのメソッドを呼び出す場合は、コールバック ルーチンを実装するゼロ (0) のディスパッチ識別子 (DSIPID) を持つ Automation オブジェクトの識別子に onProgressChanged パラメーターを設定します。 onCompleted パラメーターに対して同じことを行います。

IUpdateInstaller の 更新 プロパティが設定されていない場合、このメソッドはWU_E_NO_UPDATEを返します。 また、更新 プロパティが空のコレクションに設定されている場合、このメソッドはWU_E_NO_UPDATEを返します。

アプリで非同期 WUA API を使用する場合は、タイムアウト メカニズムの実装が必要になる場合があります。 非同期 WUA 操作を実行する方法の詳細については、「 非同期 WUA 操作のガイドライン」を参照してください。

要件

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

関連項目

IUpdateInstaller