次の方法で共有


MsiOpenPackageA 関数 (msi.h)

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

MsiOpenPackageExMsiOpenPackageEx、または MsiOpenProduct 関数を呼び出す前に、同じスレッドで COM を初期化 注意してください。

 

構文

UINT MsiOpenPackageA(
  [in]  LPCSTR    szPackagePath,
  [out] MSIHANDLE *hProduct
);

パラメーター

[in] szPackagePath

パッケージへのパス。

[out] hProduct

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

戻り値

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

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

備考

MsiOpenPackage では、開かれたデータベース ハンドルを "#nnnn" という形式で受け取ることができます。nnnn は、パッケージへのパスではなく、文字列形式のデータベース ハンドル (つまり #123) です。 これは、検証アクションの実行などの開発タスク、またはデータベース管理ツールでの使用を目的としています。

手記

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

必要条件

要件 価値
サポートされる最小クライアント 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

関連項目

製品クエリ関数の