MsiOpenPackageExA 関数 (msi.h)
MsiOpenPackageEx 関数は、製品データベースにアクセスする関数で使用するパッケージを開きます。 MsiCloseHandle 関数は、ハンドルが不要になったときにハンドルと共に呼び出す必要があります。
構文
UINT MsiOpenPackageExA(
[in] LPCSTR szPackagePath,
[in] DWORD dwOptions,
[out] MSIHANDLE *hProduct
);
パラメーター
[in] szPackagePath
パッケージへのパス。
[in] dwOptions
コンピューターの状態を無視するかどうかを示すビット フラグ。 MsiOpenPackage 動作
定数 | 意味 |
---|---|
|
製品ハンドルを作成するときに、コンピューターの状態を無視します。 |
[out] hProduct
製品ハンドルを受け取る変数へのポインター。
戻り値
価値 | 意味 |
---|---|
|
構成情報が壊れています。 |
|
製品を開くことができませんでした。 |
|
Windows インストーラーでは、リモート デスクトップ接続からのインストールは許可されません。 |
|
無効なパラメーターが関数に渡されます。 |
|
関数は正常に完了します。 |
この関数が失敗すると、システム エラー コードが返される可能性があります。 詳細については、「システム エラー コードの」を参照してください。
備考
現在のマシンの状態に依存せず、現在のマシンの状態を変更できない制限付きの製品ハンドルを作成するには、dwOptionsでMSIOPENPACKAGEFLAGS_IGNOREMACHINESTATEが設定された MsiOpenPackageEx を使用します。
dwOptions
MSIOPENPACKAGEFLAGS_IGNOREMACHINESTATEで
制限付きハンドル 使用して、次の標準アクションで msiDoAction を呼び出すことができます。 制限付きハンドルを使用して呼び出された場合、他のすべてのアクションはERROR_FUNCTION_NOT_CALLEDを返します。
- ADMIN
- アドバタイズ
- install
- SEQUENCE
-
AppSearch アクション の
- CCPSearch
- CostFinalize
- CostInitialize
- FileCost
-
FindRelatedProducts の
-
IsolateComponents アクション の
- LaunchConditions
- MigrateFeatureStates
-
ResolveSource の
- RMCCPSearch
-
ValidateProductID の
手記
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 |