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 を使用する」セクションを参照してください。
要件
| サポートされている最小のクライアント | 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 インストーラー |
| 対象プラットフォーム | Windows |
| ヘッダー | msiquery.h |
| Library | Msi.lib |
| [DLL] | Msi.dll |