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

  • [アーティクル]

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

構文

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

パラメーター

[in] onProgressChanged

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

[in] onCompleted

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

[in] state

AsyncState プロパティ IInstallationJob インターフェイスが返す呼び出し元固有の状態。

[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