MsiOpenPackageExA 関数 (msi.h)

MsiOpenPackageEx 関数は、製品データベースにアクセスする関数で使用するパッケージを開きます。 ハンドルが不要になった場合は、 MsiCloseHandle 関数を ハンドルと共に呼び出す必要があります。

構文

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

パラメーター

[in] szPackagePath

パッケージのパスです。

[in] dwOptions

コンピューターの状態を無視するかどうかを示すビット フラグ。 MsiOpenPackage の動作を使用するには、0 (ゼロ) を渡します。

[out] hProduct

製品ハンドルを受け取る変数へのポインター。

戻り値

この関数が失敗すると、システム エラー コードが返される可能性があります。 詳細については、「 システム エラー コード」を参照してください。

注釈

現在のマシンの状態に依存せず、現在のマシンの状態を変更できない制限付き製品ハンドルを作成するには、dwOptions で設定されたMSIOPENPACKAGEFLAGS_IGNOREMACHINESTATEを含む MsiOpenPackageEx を使用します。

dwOptions がMSIOPENPACKAGEFLAGS_IGNOREMACHINESTATEまたは 1 の場合、MsiOpenPackageEx は製品ハンドルの作成時に現在のマシンの状態を無視することに注意してください。 dwOptions の値が 0 の場合、MsiOpenPackageEx は MsiOpenPackage と同じであり、szPackagePath で指定されたパッケージが既にコンピューターにインストールされているかどうかに依存する製品ハンドルを作成します。

MSIOPENPACKAGEFLAGS_IGNOREMACHINESTATEで MsiOpenPackageEx を使用して作成された制限付きハンドルでは、ダイアログ、標準アクションのサブセット、およびプロパティを設定するカスタム アクション (カスタム アクションの種類 35、カスタム アクションの種類 51、カスタム アクションの種類 19) の実行のみが許可されます。 制限付きハンドルを使用すると、 ダイナミック リンク ライブラリ、 実行可能ファイル 、またはスクリプトを実行するカスタム アクション を使用できなくなります。

制限付きハンドルを使用して、次の標準アクションで MsiDoAction を呼び出すことができます。 制限付きハンドルで呼び出された場合、他のすべてのアクションはERROR_FUNCTION_NOT_CALLEDを返します。

• 管理
• ADVERTISE
• INSTALL
• SEQUENCE
• AppSearch アクション
• CCPSearch
• CostFinalize
• CostInitialize
• FileCost
• FindRelatedProducts
• IsolateComponents アクション
• LaunchConditions
• MigrateFeatureStates
• ResolveSource
• RMCCPSearch
• ValidateProductID

要件