MsiOpenPackageExA 関数 (msi.h)

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

メモMsiOpenPackage、MsiOpenPackageEx、または MsiOpenProduct 関数を呼び出す前に、同じスレッドで COM を初期化します。

 

構文

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

パラメーター

[in] szPackagePath

パッケージのパスです。

[in] dwOptions

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

定数	説明
MSIOPENPACKAGEFLAGS_IGNOREMACHINESTATE 1	製品ハンドルの作成時にコンピューターの状態を無視します。

[out] hProduct

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

戻り値

値	意味
ERROR_BAD_CONFIGURATION	構成情報が壊れています。
ERROR_INSTALL_FAILURE	製品を開けませんでした。
ERROR_INSTALL_REMOTE_PROHIBITED	Windows インストーラーでは、リモート デスクトップ接続からのインストールは許可されません。
ERROR_INVALID_PARAMETER	無効なパラメーターが関数に渡されます。
ERROR_SUCCESS	関数は正常に完了します。

 

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

注釈

現在のマシンの状態に依存せず、現在のマシンの状態を変更できない制限付き製品ハンドルを作成するには、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

ハンドルが必要ない場合は、 MsiCloseHandle 関数を呼び出す必要があります。

注意

msi.h ヘッダーは、MSIOpenPackageEx をエイリアスとして定義し、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows Server 2012、Windows 8、Windows Server 2008 R2、または Windows 7 の Windows インストーラー 5.0。 Windows Server 2008 または Windows Vista の Windows インストーラー 4.0 または Windows インストーラー 4.5。 Windows Server 2003 または Windows XP の Windows インストーラー。 Windows インストーラーのバージョン別に必須となる最小 Windows サービス パックに関する詳細については、Windows インストーラーの実行時の要件に関する記事を参照してください。
対象プラットフォーム	Windows
ヘッダー	msi.h
Library	Msi.lib
[DLL]	Msi.dll