MsiSourceListForceResolutionExA 関数 (msi.h)

  • [アーティクル]

MsiSourceListForceResolutionEx 関数は、"LastUsedSource" というプロパティの登録を削除します。 この関数は、登録されているソース リストには影響しません。 インストーラーは、ソースに製品またはパッチを再インストールする必要がある場合は常に、最初に "LastUsedSource" として登録されているソースを試みます。 失敗した場合、またはその登録がない場合、インストーラーは、有効なソースが見つかるまで、またはソースの一覧が使い果たされるまで、他の登録済みソースを検索します。 "LastUsedSource" 登録をクリアすると、インストーラーは、次にソースが必要な場合に、登録されたソースに対してソース解決を強制的に実行します。

構文

UINT MsiSourceListForceResolutionExA(
  [in]           LPCSTR            szProductCodeOrPatchCode,
  [in, optional] LPCSTR            szUserSid,
  [in]           MSIINSTALLCONTEXT dwContext,
  [in]           DWORD             dwOptions
);

パラメーター

[in] szProductCodeOrPatchCode

製品またはパッチの ProductCode またはパッチ GUID。 null で終わる文字列を使用します。 文字列が 39 文字を超える場合、関数は失敗し、ERROR_INVALID_PARAMETERを返します。 このパラメーターを NULL にすることはできません。

[in, optional] szUserSid

このパラメーターには、製品またはパッチを含むユーザー アカウントを指定する文字列 SID を指定できます。 SID は検証も解決もされません。 SID が正しくないと、ERROR_UNKNOWN_PRODUCTまたはERROR_UNKNOWN_PATCHが返される可能性があります。 マシン コンテキストを参照する場合、 szUserSID は NULL で、 dwContext はMSIINSTALLCONTEXT_MACHINEする必要があります。 マシン SID ("S-1-5-18") を使用すると、ERROR_INVALID PARAMETER が返されます。 現在のユーザー アカウントを参照する場合、 szUserSID は NULL 、 dwContext はMSIINSTALLCONTEXT_USERMANAGEDまたはMSIINSTALLCONTEXT_USERUNMANAGEDできます。

[in] dwContext

このパラメーターは、製品またはパッチ インスタンスのコンテキストを指定します。 このパラメーターには、次のいずれかの値を含めることができます。

コンテキストの種類 説明
MSIINSTALLCONTEXT_USERMANAGED
 製品またはパッチ インスタンスは、ユーザーごとのマネージド コンテキストに存在します。
MSIINSTALLCONTEXT_USERUNMANAGED
 製品またはパッチ インスタンスは、ユーザーごとのアンマネージド コンテキストに存在します。
MSIINSTALLCONTEXT_MACHINE
 製品またはパッチ インスタンスは、マシンごとのコンテキストに存在します。

[in] dwOptions

dwOptions 値は、szProductCodeOrPatchCode 値 の解釈を決定します。

フラグ 説明
MSICODE_PRODUCT
 szProductCodeOrPatchCode は製品コードです。
MSICODE_PATCH
 szProductCodeOrPatchCode はパッチ コードです。

戻り値

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

値 説明
ERROR_ACCESS_DENIED
 ユーザーには、指定したソース リストを変更する機能がありません。 製品またはパッチが見つかったかどうかを示しません。
ERROR_BAD_CONFIGURATION
 構成データが破損しています。
ERROR_INSTALL_SERVICE_FAILURE
 Windows インストーラー サービスにアクセスできませんでした
ERROR_INVALID_PARAMETER
 無効なパラメーターが関数に渡されました。
ERROR_SUCCESS
 "LastUsedSource" の登録がクリアされました。
ERROR_UNKNOWN_PATCH
 パッチが見つかりませんでした。
ERROR_UNKNOWN_PRODUCT
 指定された製品またはパッチが見つかりませんでした。
ERROR_FUNCTION_FAILED
 予期しない内部エラー。

解説

管理者は、マシン コンテキストまたはユーザーごとの独自のコンテキスト (マネージドまたはアンマネージド) の下に存在する製品またはパッチ インスタンスのインストールを変更できます。ユーザーが管理する任意のユーザーのコンテキストの下に存在する製品またはパッチ インスタンスのインストールを変更できます。 管理者は、他のユーザーの非管理対象コンテキストの下に存在する製品またはパッチ インスタンスの別のユーザーのインストールを変更することはできません。

管理者以外のユーザーは、別のユーザーのユーザーごとのコンテキスト (マネージドまたはアンマネージド) の下に存在する製品またはパッチ インスタンスのインストールを変更できません。ユーザーが管理しない独自のコンテキストの下に存在する製品またはパッチ インスタンスのインストールを変更できます。 製品またはパッチ のソースの参照が有効になっている場合にのみ、マシン コンテキストまたは独自のユーザー管理コンテキストで製品またはパッチ インスタンスのインストールを変更できます。 ユーザーは、ポリシーを設定することでソースの参照を有効にすることができます。詳細については、「 DisableBrowse、 AllowLockdownBrowse、 AlwaysInstallElevated ポリシー」を参照してください。

注意

msi.h ヘッダーは、MSISourceListForceResolutionEx をエイリアスとして定義し、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 インストーラーの実行時の要件に関する記事を参照してください。
対象プラットフォーム Windows
ヘッダー msi.h
Library Msi.lib
[DLL] Msi.dll

関連項目

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

ProductCode

ソースの回復性