MsiGetPatchInfoExW 関数 (msi.h)

MsiGetPatchInfoEx 関数は、製品の指定されたインスタンスへのパッチの適用に関する情報を照会します。

構文

UINT MsiGetPatchInfoExW(
  [in]            LPCWSTR           szPatchCode,
  [in]            LPCWSTR           szProductCode,
  [in]            LPCWSTR           szUserSid,
  [in]            MSIINSTALLCONTEXT dwContext,
  [in]            LPCWSTR           szProperty,
  [out, optional] LPWSTR            lpValue,
  [in, out]       LPDWORD           pcchValue
);

パラメーター

[in] szPatchCode

パッチの GUID を含む null で終わる文字列。 このパラメーターを NULL にすることはできません。

[in] szProductCode

製品インスタンスの ProductCode GUID を含む null で終わる文字列。 このパラメーターを NULL にすることはできません。

[in] szUserSid

クエリ対象のパッチのインスタンスが存在するセキュリティ識別子 (SID) を指定する null で終わる文字列。 NULL 値を使用すると、現在のユーザーが指定されます。

[in] dwContext

列挙を、ユーザーごとのアンマネージド、ユーザーごとの管理、またはマシンごとのコンテキストに制限します。 このパラメーターには、次のいずれかの値を指定できます。

[in] szProperty

取得するプロパティ値を指定する null で終わる文字列。 szProperty パラメーターには、次のいずれかを指定できます。

[out, optional] lpValue

このパラメーターは、プロパティ値を受け取るバッファーへのポインターです。 このバッファーは、情報を格納するのに十分な大きさにする必要があります。 バッファーが小さすぎる場合、関数は ERROR_MORE_DATA を返し、*pcchValue をプロパティ値の TCHAR の数に設定します。終端の NULL 文字は含まれません。

lpValue が NULL に設定され、pcchValue が有効なポインターに設定されている場合、関数は ERROR_SUCCESSを返し、終了する NULL 文字を含まない値の TCHAR の数に *pcchValue を設定します。 その後、関数を再度呼び出して値を取得できます。 lpValue バッファーは、*pcchValue + 1 文字を含むのに十分な大きさです。

lpValue と pcchValue の両方が NULL に設定されている場合、値が存在する場合、関数は値を取得せずにERROR_SUCCESSを返します。

[in, out] pcchValue

関数を呼び出すとき、このパラメーターは lpValue バッファー内の TCHAR の数を指定する変数へのポインターである必要があります。 関数が戻るとき、関数が指定したバッファーに値をコピーするかどうかに関係なく、このパラメーターは要求された値のサイズに設定されます。 サイズは、要求された値の TCHAR の数として返されます。終端の null 文字は含まれません。

このパラメーターは、lpValue が NULL の場合にのみ NULL に設定できます。 それ以外の場合、関数は ERROR_INVALID_PARAMETERを返します。

戻り値

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

解説

Windows インストーラー 2.0: サポートされていません。 この関数は、Windows インストーラー バージョン 3.0 以降で使用できます。

ユーザーは、表示されている製品インスタンスのパッチ データに対してクエリを実行できます。 管理者グループは、コンピューター上の任意の製品インスタンスと任意のユーザーのパッチ データに対してクエリを実行できます。 ユーザーがログオンしていない場合、すべての値がユーザーごとの非マネージド アプリケーションで使用できるわけではありません。

要件

関連項目

ProductCode

パッチの削除