MsiGetSummaryInformationA 函式 （msiquery.h）

MsiGetSummaryInformation 函式會取得安裝程式資料庫的_SummaryInformation數據流句柄。 此函式會傳回應該使用 MsiCloseHandle關閉的句柄。

語法

UINT MsiGetSummaryInformationA(
  [in]  MSIHANDLE hDatabase,
  [in]  LPCSTR    szDatabasePath,
  [in]  UINT      uiUpdateCount,
  [out] MSIHANDLE *phSummaryInfo
);

參數

[in] hDatabase

資料庫的句柄。

[in] szDatabasePath

指定資料庫的路徑。

[in] uiUpdateCount

指定更新值的最大數目。

[out] phSummaryInfo

要從中接收摘要資訊句柄的位置指標。

傳回值

MsiGetSummaryInformation 函式會傳回下列值：

言論

如果 MsiGetSummaryInformation 函式所指定的資料庫未開啟，您必須為 hDatabase 指定 0，並在 szDatabasePath 中指定資料庫的路徑。 如果資料庫已開啟，您必須將 szDatabasePath 設定為 0。

如果使用大於 0 的 uiUpdateCount 值來開啟現有的摘要資訊數據流 ，必須先呼叫 msiSummaryInfoPersist，才能關閉 phSummaryInfo 句柄 。 若無法這麼做，將會遺失現有的數據流資訊。

若要使用 MsiGetSummaryInformation來檢視修補程式的摘要資訊，請將 szDatabasePath 設定為修補程式的路徑。 或者，您可以使用 MsiOpenDatabase 建立修補程式的句柄，然後將該句柄傳遞至 MsiGetSummaryInformation 作為 hDatabase 參數。

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

如果函式失敗，您可以使用 MsiGetLastErrorRecord取得擴充錯誤資訊。

注意

msiquery.h 標頭會根據 UNICODE 預處理器常數的定義，將 MsiGetSummaryInformation 定義為自動選取此函式的 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
目標平臺	窗戶
標頭	msiquery.h
連結庫	Msi.lib
DLL	Msi.dll

另請參閱

摘要資訊屬性函式

摘要信息數據流屬性集