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」プロパティを参照してください。

戻り値

値 説明
ERROR_SUCCESS
 関数は正常に完了します。
アクションに関連するエラー
 詳細については、エラー コードに関する記事を参照してください。
初期化エラー
 初期化に関連するエラーが発生しました。
 

詳細については、「 表示されたエラー メッセージ」を参照してください。

解説

MsiInstallProduct 関数は、現在の設定とログ モードを持つユーザー インターフェイスを表示します。

  • ユーザー インターフェイスの設定は、 MsiSetInternalUI、 MsiSetExternalUI、または MsiSetExternalUIRecord 関数を使用して変更できます。
  • ログ モードは、 MsiEnableLog 関数を使用して設定できます。
  • 製品を完全に削除するには、 szCommandLine で REMOVE=ALL を設定します。
詳細については、「 REMOVE プロパティ」を参照してください。

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

関連項目

表示されるエラー メッセージ

エラー コード

初期化エラー

インストールと構成の関数

複数パッケージのインストール