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