更新プログラムの非同期インストールを開始します。
構文
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 を返します。
エラー コード。
| リターン コード | Description |
|---|---|
|
更新プログラムの非同期インストールが正常に開始されました。 |
|
インストーラーが更新プログラムをインストールまたは削除するときに、このメソッドを呼び出すことはできません。
IUpdateInstaller インターフェイスの IsBusy プロパティがVARIANT_FALSEを返す場合にのみ、このメソッドを呼び出します。 |
|
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 |