MsiOpenPackageExA 函式 (msi.h)

MsiOpenPackageEx 函式會開啟套件，以搭配存取產品資料庫的函式使用。 當不再需要句柄時，必須使用句柄呼叫 MsiCloseHandle 函式。

注意 在呼叫 MsiOpenPackage、 MsiOpenPackageEx 或 MsiOpenProduct 函式之前，請先在相同的線程上初始化 COM。

 

語法

UINT MsiOpenPackageExA(
  [in]  LPCSTR    szPackagePath,
  [in]  DWORD     dwOptions,
  [out] MSIHANDLE *hProduct
);

參數

[in] szPackagePath

封裝的路徑。

[in] dwOptions

要指出是否要忽略計算機狀態的位旗標。 傳入 0 (零) ，以使用 MsiOpenPackage 行為。

常數	意義
MSIOPENPACKAGEFLAGS_IGNOREMACHINESTATE 1	在建立產品句柄時忽略計算機狀態。

[out] hProduct

接收產品句柄之變數的指標。

傳回值

值	意義
ERROR_BAD_CONFIGURATION	組態資訊已損毀。
ERROR_INSTALL_FAILURE	無法開啟產品。
ERROR_INSTALL_REMOTE_PROHIBITED	Windows Installer 不允許從遠端桌面連線進行安裝。
ERROR_INVALID_PARAMETER	無效的參數會傳遞至 函式。
ERROR_SUCCESS	函式順利完成。

 

如果此函式失敗，可能會傳回系統錯誤碼。 如需詳細資訊，請參閱 系統錯誤碼。

備註

若要建立與目前計算機狀態無關且無法變更目前計算機狀態的限制產品句柄，請使用 MsiOpenPackageEx 搭配 dwOptions 中設定的 MSIOPENPACKAGEFLAGS_IGNOREMACHINESTATE。

請注意，如果 dwOptions 是MSIOPENPACKAGEFLAGS_IGNOREMACHINESTATE或 1，MsiOpenPackageEx 會在建立產品句柄時忽略目前的電腦狀態。 如果 dwOptions 的值是 0，MsiOpenPackageEx 與 MsiOpenPackage 相同，並建立產品句柄，取決於 szPackagePath 指定的套件是否已安裝在電腦上。

使用 MsiOpenPackageEx 搭配MSIOPENPACKAGEFLAGS_IGNOREMACHINESTATE所建立的限制句柄只允許執行對話框、標準動作的子集，以及設定自定義 動作類型 35、 自定義動作類型 51 和 自定義動作類型 19) ( 屬性的自定義動作子集。 受限制的句柄可防止使用執行 Dynamic-Link 連結庫、 可執行檔 或 腳本的自定義動作。

您可以使用受限制的句柄，在下列標準動作上呼叫 MsiDoAction 。 如果以受限制的句柄呼叫，所有其他動作都會傳回ERROR_FUNCTION_NOT_CALLED。

• 管理員
• 做廣告
• 安裝
• SEQUENCE
• AppSearch 動作
• CCPSearch
• CostFinalize
• CostInitialize
• FileCost
• FindRelatedProducts
• IsolateComponents 動作
• LaunchConditions
• MigrateFeatureStates
• ResolveSource
• RMCCPSearch
• ValidateProductID

不需要句柄時，必須呼叫 MsiCloseHandle 函式。

注意

msi.h 標頭會根據 UNICODE 預處理器常數的定義，將 MsiOpenPackageEx 定義為別名，自動選取此函式的 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 Installer 版本所需的最低 Windows Service Pack 相關信息，請參閱 Windows Installer Run-Time 需求。
目標平台	Windows
標頭	msi.h
程式庫	Msi.lib
Dll	Msi.dll