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

另請參閱

資料庫和修補程式範例

一般數據庫存取函式