MsiInstallProductA 関数 (msi.h)
MsiInstallProduct 関数は、製品をインストールまたはアンインストールします。
構文
UINT MsiInstallProductA(
[in] LPCSTR szPackagePath,
[in] LPCSTR szCommandLine
);
パラメーター
[in] szPackagePath
Windows インストーラー パッケージの場所へのパスを指定する null で終わる文字列。 文字列値には、URL (例: http://packageLocation/package/package.msi
)、ネットワーク パス (\packageLocation\package.msi など)、ファイル パス (file://packageLocation/package.msi など)、またはローカル パス (D:\packageLocation\package.msi など) を含めることができます。
[in] szCommandLine
コマンド ライン プロパティの設定を指定する null で終わる文字列。 これは、 Property=Setting Property=Setting という形式の一覧である必要があります。 詳細については、「プロパティについて」を参照してください。
管理インストールを実行するには、 szCommandLine に ACTION=ADMIN を含めます。 詳細については、「ACTION」プロパティを参照してください。
戻り値
値 | 説明 |
---|---|
|
関数は正常に完了します。 |
|
詳細については、エラー コードに関する記事を参照してください。 |
初期化に関連するエラーが発生しました。 |
詳細については、「 表示されたエラー メッセージ」を参照してください。
解説
MsiInstallProduct 関数は、現在の設定とログ モードを持つユーザー インターフェイスを表示します。
- ユーザー インターフェイスの設定は、 MsiSetInternalUI、 MsiSetExternalUI、または MsiSetExternalUIRecord 関数を使用して変更できます。
- ログ モードは、 MsiEnableLog 関数を使用して設定できます。
- 製品を完全に削除するには、 szCommandLine で REMOVE=ALL を設定します。
Note
msi.h ヘッダーは、MSIInstallProduct をエイリアスとして定義します。これは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
サポートされている最小のクライアント | Windows Server 2012、Windows 8、Windows Server 2008 R2、または Windows 7 の Windows インストーラー 5.0。 Windows Server 2008 または Windows Vista の Windows インストーラー 4.0 または Windows インストーラー 4.5。 Windows インストーラーのバージョンで必要な最小 Windows サービス パックに関する情報については、Windows インストーラーの実行時の要件に関する記事を参照してください。 |
対象プラットフォーム | Windows |
ヘッダー | msi.h |
Library | Msi.lib |
[DLL] | Msi.dll |