UninstallApplication 関数 (appmgmt.h)

UninstallApplication 関数は、Windows インストーラー .msi ファイルを使用してセットアップとインストールを処理するグループ ポリシー アプリケーションをアンインストールします。 UninstallApplication 関数は、ユーザー グループ ポリシー アプリケーションが以前に MsiConfigureProduct 関数を呼び出してアンインストールを試みたユーザーのコンテキストでのみ呼び出す必要があります。 InstallApplication 関数は、グループ ポリシー アプリケーションをインストールできます。

メモ グループ ポリシー ベースのアプリケーションをアンインストールするためのプロトコルの一部として UninstallApplication を呼び出せなかった場合、 ポリシーの結果セット (RSoP) が不正確な情報を示す可能性があります。

 

構文

DWORD UninstallApplication(
  [in] LPWSTR ProductCode,
  [in] DWORD  dwStatus
);

パラメーター

[in] ProductCode

アンインストールする製品の Windows インストーラー 製品コード。 アプリケーションの 製品コード は、中かっこ付きの文字列として Windows インストーラー GUID の形式で提供する必要があります。

[in] dwStatus

アンインストール試行の状態。 dwStatus パラメーターは、MsiConfigureProduct によって返されるアンインストール試行の Windows 成功コードです。 システムはこれを使用して、ポリシー の結果セット (RSoP) がアンインストールに失敗したか成功したかを示します。

戻り値

関数が成功した場合、戻り値は ERROR_SUCCESS。 それ以外の場合、関数はシステム エラー コードのいずれかを返します。 エラー コードの完全な一覧については、「 システム エラー コード 」またはヘッダー ファイル WinError.h を参照してください。

注釈

Windows インストーラー関数 MsiConfigureProduct を呼び出して、.msi ファイルを使用するグループ ポリシー アプリケーションを削除して、アプリケーションをアンインストールします。 次に UninstallApplication を呼び出して、アプリケーションがクライアントで管理されなくなったことをグループ ポリシーシステムに通知します。 アンインストールに失敗した場合でも UninstallApplication を呼び出す必要があります。これにより、システムはポリシーの結果セット (RSoP) を正確に保つことができます。

インストール アプリケーションに固有のアンインストール関数またはコマンドを呼び出して、ソフトウェア インストール設定 (.zap ファイル) を使用してインストールされたアプリケーションを削除します。 Windows インストーラー以外のインストール アプリケーションの使用については、Microsoft サポート技術情報の「.zap ファイルを使用して MSI 以外のプログラムを発行する方法」231747記事を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows Vista
サポートされている最小のサーバー	Windows Server 2008
対象プラットフォーム	Windows
ヘッダー	appmgmt.h
Library	Advapi32.lib
[DLL]	Advapi32.dll

こちらもご覧ください

グループ ポリシー関数

グループ ポリシーの概要

InstallApplication

MsiConfigureProduct