MsiGetActiveDatabase 関数 (msiquery.h)

MsiGetActiveDatabase 関数は、インストール用のアクティブなデータベースを返します。 この関数は、 MsiCloseHandle を使用して閉じる必要がある読み取り専用ハンドルを返します。

構文

MSIHANDLE MsiGetActiveDatabase(
  [in] MSIHANDLE hInstall
);

パラメーター

[in] hInstall

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

戻り値

関数が成功すると、インストーラーによって現在使用されているデータベースに対して読み取り専用ハンドルが返されます。 関数が失敗した場合、関数は 0 を返します。

解説

MsiGetActiveDatabase 関数は、インストールの実行中に使用中のデータベースにアクセスします。

PMSIHANDLE 型の変数は、インストーラーがスコープ外に出ると PMSIHANDLE オブジェクトを閉じるのに対し、 MsiCloseHandle を呼び出して MSIHANDLE オブジェクトを閉じる必要があるため、PMSIHANDLE 型の変数を使用することをお勧めします。 詳細については、「Windows インストーラーのベスト プラクティス」の「HANDLE の代わりに PMSIHANDLE を使用する」セクションを参照してください。

要件

関連項目

一般的なデータベース アクセス関数