InstallApplication 関数 (appmgmt.h)
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で導入) |