次の方法で共有

MsiDetermineApplicablePatchesA 関数 (msi.h)

  • [アーティクル]

MsiDetermineApplicablePatches 関数は、一連のパッチ ファイル、XML ファイル、および XML BLOB を受け取り、指定された Windows インストーラー パッケージに適用される修正プログラムとその順序を決定します。 この関数は、置き換えられたパッチまたは古いパッチを考慮できます。 この機能は、セットに指定されていないシステムにインストールされている製品またはパッチを考慮しません。

構文

UINT MsiDetermineApplicablePatchesA(
  [in] LPCSTR                 szProductPackagePath,
  [in] DWORD                  cPatchInfo,
  [in] PMSIPATCHSEQUENCEINFOA pPatchInfo
);

パラメーター

[in] szProductPackagePath

.msi ファイルへの完全パス。 この関数は、このパッケージに適用できるパッチを、どのような順序で決定します。

[in] cPatchInfo

配列内のパッチの数。 0 より大きい値にする必要があります。

[in] pPatchInfo

MSIPATCHSEQUENCEINFO 構造体 配列へのポインター。

戻り値

MsiDetermineApplicablePatches 関数は、次の値を返します。

価値 意味
ERROR_FUNCTION_FAILED
 この関数は、他のエラー コードでは説明されていない方法で失敗しました。
ERROR_INVALID_PARAMETER
 引数が無効です。
ERROR_PATCH_NO_SEQUENCE
 パッチのセットに対して有効なシーケンスが見つかりませんでした。
ERROR_SUCCESS
 パッチが正常に並べ替えられました。
ERROR_FILE_NOT_FOUND
 .msi ファイルが見つかりませんでした。
ERROR_PATH_NOT_FOUND
 .msi ファイルへのパスが見つかりませんでした。
ERROR_INVALID_PATCH_XML
 XML パッチ データが無効です。
ERROR_INSTALL_PACKAGE_OPEN_FAILED
 パスによって参照されるインストール パッケージを開くことができません。
ERROR_CALL_NOT_IMPLEMENTED
 このエラーは、カスタム アクション から関数が呼び出された場合、または MSXML 3.0 がインストールされていない場合に返される可能性があります。

備考

この関数がカスタム アクションから呼び出されると失敗し、ERROR_CALL_NOT_IMPLEMENTEDが返されます。 この関数では、XML を処理するために MSXML バージョン 3.0 が必要であり、MSXML 3.0 がインストールされていない場合はERROR_CALL_NOT_IMPLEMENTEDを返します。

MsiDetermineApplicablePatches 関数は、pPatchInfoが指す各 MSIPATCHSEQUENCEINFO 構造体の uStatus および dwOrder メンバーを設定します。 各構造体には、特定のパッチに関する情報が含まれています。

関数が成功した場合、製品に適用できるすべてのパッチの MSIPATCHSEQUENCEINFO 構造体は、ERROR_SUCCESSの uStatus と、dwOrder 0 以上で返されます。 dwOrder 0 以上の値は、0 から始まるパッチに最適なアプリケーション シーケンスを示します。

関数が成功した場合、最適な修正プログラムの適用シーケンスから除外された修正プログラムは、dwOrder -1 と等しい MSIPATCHSEQUENCEINFO 構造体を返します。 このような場合、ERROR_SUCCESSの uStatus フィールドは、製品の古いパッチまたは置き換えられたパッチを示します。 ERROR_PATCH_TARGET_NOT_FOUND の uStatus フィールドは、製品に適用できないパッチを示します。

関数が失敗した場合、すべてのパッチの MSIPATCHSEQUENCEINFO 構造体は、-1 と等しい dwOrder 返します。 この場合、uStatus フィールドには、個々のパッチに関する詳細情報を含むエラーが含まれている可能性があります。 たとえば、循環シーケンス情報を持つパッチのERROR_PATCH_NO_SEQUENCEが返されます。

手記

msi.h ヘッダーは、MSIDetermineApplicablePatches をエイリアスとして定義し、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 インストーラー 3.0 以降。 Windows インストーラーのバージョンで必要な最小 Windows Service Pack の詳細については、Windows インストーラーの Run-Time 要件を参照してください。
ターゲット プラットフォーム の ウィンドウズ
ヘッダー msi.h
ライブラリ Msi.lib
DLL Msi.dll

関連項目

MsiDeterminePatchSequence

Windows インストーラー 2.0 以前の ではサポートされていません

ProductCode を する