次の方法で共有


MsiOpenPackageExA 関数 (msi.h)

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

MsiOpenPackageExMsiOpenPackageEx、または 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 の場合、MsiOpenPackageExMsiOpenPackage と同じであり、szPackagePath で指定されたパッケージが既にコンピューターにインストールされているかどうかに依存する製品ハンドルを作成します。

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

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

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 Service Pack の詳細については、Windows インストーラーの Run-Time 要件を参照してください。
ターゲット プラットフォーム の ウィンドウズ
ヘッダー msi.h
ライブラリ Msi.lib
DLL Msi.dll