MsiDoActionA 関数 (msiquery.h)

MsiDoAction 関数は、組み込みアクション、カスタム アクション、またはユーザー インターフェイス ウィザード アクションを実行します。

構文

UINT MsiDoActionA(
  [in] MSIHANDLE hInstall,
  [in] LPCSTR    szAction
);

パラメーター

[in] hInstall

DLL カスタム アクションに提供されるインストール、または MsiOpenPackage、MsiOpenPackageEx、または MsiOpenProduct使用して取得されるインストールを処理します。

[in] szAction

実行するアクションを指定します。

戻り値

この関数は UINT を返します。

備考

MsiDoAction 関数は、指定された名前に対応するアクションを実行します。 名前が組み込みアクションとして、または CustomAction テーブルのカスタム アクションとしてインストーラーによって認識されない場合、名前は、関数またはダイアログ ボックスを呼び出すことができるユーザー インターフェイス ハンドラー オブジェクトに渡されます。 null アクション名が指定されている場合、インストーラーは実行するアクションとして ACTION プロパティの大文字の値を使用します。 プロパティ値が定義されていない場合は、"INSTALL" として定義された既定のアクションが実行されます。

InstallFiles や WriteRegistryValues アクション など、システムを更新するアクション MsiDoActionを呼び出して実行することはできません。 このルールの例外は、InstallInitialize と InstallFinalize アクションの間で InstallExecuteSequence テーブルでスケジュールされたカスタム アクションから msiDoAction 呼び出される場合です。 AppSearch や CostInitializeなど、システムを更新しないアクションを呼び出すことができます。

手記

msiquery.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして MsiDoAction を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件	価値
サポートされる最小クライアント	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 Server 2003 または Windows XP の Windows インストーラー
ターゲット プラットフォーム の	ウィンドウズ
ヘッダー	msiquery.h
ライブラリ	Msi.lib
DLL	Msi.dll

関連項目

インストーラーアクション関数の