共用方式為


msiOpenDatabaseA 函式 (msiquery.h)

MsiOpenDatabase 函式會開啟資料庫檔案以供數據存取。 此函式會傳回應該使用 MsiCloseHandle 關閉的句柄。

語法

UINT MsiOpenDatabaseA(
  [in]  LPCSTR    szDatabasePath,
  [in]  LPCSTR    szPersist,
  [out] MSIHANDLE *phDatabase
);

參數

[in] szDatabasePath

指定資料庫檔案的完整路徑或相對路徑。

[in] szPersist

接收檔案或持續性模式的完整路徑。 您可以使用 szPersist 參數,將持續性輸出導向新檔案,或指定下列其中一個預先定義的持續性模式。

意義
MSIDBOPEN_CREATEDIRECT
建立新的資料庫,直接模式讀取/寫入。
MSIDBOPEN_CREATE
建立新的資料庫,交易模式讀取/寫入。
MSIDBOPEN_DIRECT
在沒有交易的情況下開啟資料庫直接讀取/寫入。
MSIDBOPEN_READONLY
開啟資料庫唯讀,不持續變更。
MSIDBOPEN_TRANSACT
在交易模式中開啟資料庫讀取/寫入。
MSIDBOPEN_PATCHFILE
新增此旗標以指出修補程序檔案。

[out] phDatabase

傳回之資料庫句柄位置的指標。

傳回值

MsiOpenDatabase 函式會傳回下列值:

備註

若要對資料庫進行變更並儲存變更,請先在交易 (MSIDBOPEN_TRANSACT) 中開啟資料庫、建立 (MSIDBOPEN_CREATE 或MSIDBOPEN_CREATEDIRECT) ,或直接 (MSIDBOPEN_DIRECT) 模式。 進行變更之後,請先呼叫 MsiDatabaseCommit ,再關閉資料庫句柄。 MsiDatabaseCommit 會排清所有緩衝區。

在直接模式中開啟的資料庫上,請一律呼叫 MsiDatabaseCommit (MSIDBOPEN_DIRECT 或MSIDBOPEN_CREATEDIRECT) ,再關閉資料庫的句柄。 無法這樣做可能會損毀資料庫。

因為 MsiOpenDatabase 起始數據庫存取權,所以無法搭配執行中的安裝使用。

請注意,建議使用 PMSIHANDLE 類型的變數,因為安裝程式會在超出範圍時關閉 PMSIHANDLE 物件,而您必須呼叫 MsiCloseHandle 來關閉 MSIHANDLE 物件。 如需詳細資訊,請參閱 Windows Installer 最佳做法中的使用 PMSIHANDLE 而非 HANDLE 一節。

注意 當資料庫開啟為另一個資料庫的輸出時,輸出資料庫的摘要資訊數據流實際上是原始資料庫的只讀鏡像,因此無法變更。 此外,它不會與資料庫一起保存。 若要建立或修改輸出資料庫的摘要資訊,必須關閉並重新開啟。
 
如果函式失敗,您可以使用 MsiGetLastErrorRecord 取得擴充錯誤資訊。

注意

msiquery.h 標頭會將 MsiOpenDatabase 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例

規格需求

需求
最低支援的用戶端 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

另請參閱

資料庫和修補程式範例

一般數據庫存取函式