msiGetActiveDatabase 函式 (msiquery.h)
MsiGetActiveDatabase函式會傳回安裝的作用中資料庫。 此函式會傳回應該使用 MsiCloseHandle關閉的唯讀控制碼。
語法
MSIHANDLE MsiGetActiveDatabase(
[in] MSIHANDLE hInstall
);
參數
[in] hInstall
處理提供給 DLL 自訂動作的安裝,或透過 MsiOpenPackage、 MsiOpenPackageEx或 MsiOpenProduct取得。
傳回值
如果函式成功,它會將唯讀控制碼傳回安裝程式目前使用的資料庫。 如果函式失敗,函式會傳回零,0。
備註
MsiGetActiveDatabase函式會存取執行安裝所使用的資料庫。
請注意,建議您使用 PMSIHANDLE 類型的變數,因為安裝程式會在 PMSIHANDLE 物件超出範圍時關閉 PMSIHANDLE 物件,而您必須呼叫 MsiCloseHandle 來關閉 MSIHANDLE物件。 如需詳細資訊,請參閱Windows Installer 最佳做法中的使用 PMSIHANDLE 而非 HANDLE一節。
需求
最低支援的用戶端 | Windows Server 2012、Windows 8、Windows Server 2008 R2 或 Windows 7 上的 Windows Installer 5.0。 Windows Server 2008 或 Windows Vista 上的 Windows Installer 4.0 或 Windows Installer 4.5。 Windows Server 2003 或 Windows XP 上的 Windows Installer |
目標平台 | Windows |
標頭 | msiquery.h |
程式庫 | Msi.lib |
Dll | Msi.dll |