InstallApplication 関数 (appmgmt.h)

[アーティクル]
03/14/2023

InstallApplication 関数は、ドメインに属するターゲットユーザーに展開されたアプリケーションをインストールできます。 InstallApplication を呼び出しているユーザーのセキュリティコンテキストは、ターゲットユーザーのドメインを信頼するドメイン内のコンピューターにログオンしているドメインユーザーのセキュリティコンテキストである必要があります。ターゲットユーザーがログオンしたときに、グループポリシーが正常に適用される必要があります。

構文

DWORD InstallApplication(
  [in] PINSTALLDATA pInstallInfo
);

パラメーター

[in] pInstallInfo

インストールするアプリケーションを指定する INSTALLDATA 構造体へのポインター。

戻り値

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

注釈

InstallApplication 関数は、グループポリシーを使用して展開されたアプリケーションのみをインストールできます。ドメイン管理者は、グループポリシーオブジェクト (GPO) のユーザー構成セクションを使用して、ターゲットユーザーにアプリケーションを展開できます。ターゲットユーザーはターゲットドメインに属している必要があり、GPO はターゲットドメイン内のこのユーザーに適用する必要があります。 InstallApplication 関数は、標準のグループポリシー継承規則に従ってアプリケーションをインストールします。同じアプリケーションが複数の GPO に展開されている場合、関数は、最も優先順位の高い GPO に展開されたアプリケーションのバージョンをインストールします。ユーザーのアプリケーションがインストールされると、コンピューター上の他のユーザーには表示されません。これは、ユーザーグループポリシーを使用して展開されるアプリケーションの標準です。

InstallApplication 関数は、Windows インストーラー (.msi ファイル) またはソフトウェアインストール設定 (.zap ファイル) を使用してセットアップとインストールを処理する展開済みアプリケーションをインストールできます。

InstallApplication 関数は、インストールに Windows インストーラーパッケージを使用するアプリケーションをインストールできます。この場合、 InstallApplication を呼び出すユーザーは、管理者権限を持っている必要はありません。 Windows インストーラーはドメイン管理者によって展開された信頼できるアプリケーションであるため、システムはアプリケーションをインストールできます。アプリケーションを受け取るユーザーは、.msi ファイルの場所にアクセスできる必要があります。

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

InstallApplication 関数は、ソフトウェアインストール設定 (.zap ファイル) に基づいてセットアップアプリケーションを使用するアプリケーションをインストールすることもできます。アプリケーションを受け取るユーザーは、.zap ファイルの場所にアクセスできる必要があります。 .zap ファイルは、.ini ファイルに似たテキストファイルです。これにより、Windows はプログラムの 追加または削除を使用してインストールするためのアプリケーション (たとえば、Setup.exe) を発行できます。 Windows インストーラーを使用しないアプリケーションを発行するには、.zap ファイルを作成し、.zap ファイルをソフトウェア配布ポイントサーバーにコピーしてから、グループポリシーベースのソフトウェア展開を使用してユーザー用にアプリケーションを発行する必要があります。アプリケーションが .zap ファイルを使用して展開されている場合、アプリケーションをインストールするユーザーは、ソフトウェアをインストールするためのマシンに対する特権を持っている必要があります。割り当てられたアプリケーションに .zap ファイルを使用することはできません。

アンインストール関数またはインストールアプリケーションに固有のコマンドを呼び出して、ソフトウェアインストール設定 (.zap ファイル) を使用してアプリケーションを削除します。

Windows インストーラー以外のインストールアプリケーションの使用については、マイクロソフトサポート技術情報の「.zap ファイルを使用して MSI 以外のプログラムを発行する方法」231747記事を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows Vista
サポートされている最小のサーバー	Windows Server 2008
対象プラットフォーム	Windows
ヘッダー	appmgmt.h
Library	Advapi32.lib
[DLL]	Advapi32.dll
API セット	ext-ms-win-advapi32-msi-l1-1-0 (Windows 8で導入)