次の方法で共有

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 を返します。

エラー コード。

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

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

注釈

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

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

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

Requirements

Requirement 価値
サポートされる最小クライアント Windows XP、Windows 2000 Professional SP3 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003、Windows 2000 Server SP3 [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
Header wuapi.h
Library Wuguid.lib
DLL Wuapi.dll

こちらも参照ください

IUpdateInstaller

  • Last updated on