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 Library、可執行檔 或 腳本的自定義動作。

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

• ADMIN
• 公告
• INSTALL
• 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 需求。
目標平臺	窗戶
標頭	msi.h
連結庫	Msi.lib
DLL	Msi.dll