次の方法で共有

MsiDeterminePatchSequenceA 関数 (msi.h)

  • [アーティクル]

MsiDeterminePatchSequence 関数は、一連のパッチ ファイル、XML ファイル、および XML BLOB を受け取り、指定されたインストール済み製品に対するパッチの最適なアプリケーション シーケンスを決定します。 この関数は、製品に既に適用されているパッチを考慮し、古いパッチと置き換えられたパッチを考慮します。

構文

UINT MsiDeterminePatchSequenceA(
  [in]           LPCSTR                 szProductCode,
  [in, optional] LPCSTR                 szUserSid,
  [in]           MSIINSTALLCONTEXT      dwContext,
  [in]           DWORD                  cPatchInfo,
  [in]           PMSIPATCHSEQUENCEINFOA pPatchInfo
);

パラメーター

[in] szProductCode

パッチのセットのターゲットである製品。 値は、製品の ProductCode GUID である必要があります。

[in, optional] szUserSid

ユーザーのセキュリティ識別子 (SID) を指定する null で終わる文字列。 このパラメーターは、このユーザー アカウントの列挙のコンテキストを制限します。 このパラメーターは、特殊な SID 文字列 "S-1-1-0" (everyone) または "S-1-5-18" (ローカル システム) にすることはできません。 コンピューター コンテキスト dwContext が MSIINSTALLCONTEXT_MACHINE に設定され、szUserSid が NULLする必要があります。 現在のユーザー コンテキストでは、szUserSid null を指定でき、dwContext を MSIINSTALLCONTEXT_USERMANAGED または MSIINSTALLCONTEXT_USERUNMANAGEDに設定できます。

[in] dwContext

列挙を、ユーザーごとの非管理対象、ユーザーごとの管理、またはコンピューターごとのコンテキストに制限します。 このパラメーターには、次のいずれかの値を指定できます。

コンテキストの種類 意味
MSIINSTALLCONTEXT_USERMANAGED
 パッチは、szUserSidで指定されたユーザーの製品のすべてのユーザー管理インストールに対して考慮されます。 このコンテキストで szUserSid null は、現在のユーザーを意味します。
MSIINSTALLCONTEXT_USERUNMANAGED
 パッチは、szUserSidで指定されたユーザーのすべての非管理対象インストールに対して考慮されます。 このコンテキストで szUserSid null は、現在のユーザーを意味します。
MSIINSTALLCONTEXT_MACHINE
 パッチは、マシンごとのインストールと見なされます。 dwContext が MSIINSTALLCONTEXT_MACHINE に設定されている場合、szUserSid パラメーターは null である必要があります。

[in] cPatchInfo

配列内のパッチの数。

[in] pPatchInfo

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

戻り値

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

価値 意味
ERROR_FUNCTION_FAILED
 この関数は、他のエラー コードでは説明されていない方法で失敗しました。
ERROR_INVALID_PARAMETER
 引数が無効です。
ERROR_PATCH_NO_SEQUENCE
 パッチのセットに対して有効なシーケンスが見つかりませんでした。
ERROR_INSTALL_PACKAGE_OPEN_FAILED
 パスによって参照されるインストール パッケージを開くことができません。
ERROR_SUCCESS
 パッチが正常に並べ替えられました。
ERROR_FILE_NOT_FOUND
 .msi ファイルが見つかりませんでした。
ERROR_PATH_NOT_FOUND
 .msi ファイルへのパスが見つかりませんでした。
ERROR_INVALID_PATCH_XML
 XML パッチ データが無効です。
ERROR_INSTALL_PACKAGE_INVALID
 インストール パッケージが無効です。
ERROR_ACCESS_DENIED
 管理者ではないユーザーが、別のユーザーのコンテキストで関数を呼び出そうとしました。
ERROR_BAD_CONFIGURATION
 登録済みのパッチまたは製品の構成データが無効です。
ERROR_UNKNOWN_PRODUCT
 指定された ProductCode GUID は登録されません。
ERROR_FUNCTION_NOT_CALLED
 最適なパッチ シーケンスを決定するには、Windows インストーラー バージョン 3.0 が必要です。 この関数は、windows インストーラー バージョン 3.0 でまだインストールされていない szProductCode で呼び出されました。
ERROR_CALL_NOT_IMPLEMENTED
 このエラーは、カスタム アクション から関数が呼び出された場合、または MSXML 3.0 がインストールされていない場合に返される可能性があります。
ERROR_UNKNOWN_PATCH
 指定されたパッチが不明です。

備考

管理者特権を持たないユーザーは、自分またはコンピューターのコンテキストでのみこの関数を呼び出すことができます。 管理者であるユーザーは、他のユーザーに対して呼び出すことができます。

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

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

必要条件

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

関連項目

MSIPATCHSEQUENCEINFO の

MsiDetermineApplicablePatches

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

ProductCode を する