次の方法で共有

MsiSourceListClearSourceA 関数 (msi.h)

  • [アーティクル]

MsiSourceListClearSource 関数は、指定されたコンテキストで製品またはパッチの既存のソースを削除します。 パッチの唯一のソースが削除され、パッチが同じコンテキストでクライアントによってインストールされていない場合、パッチの登録も削除されます。 MsiSourceListClearSource この製品またはパッチの現在のソースを削除するように指定すると、インストーラーは、次にソースが必要な場合にソースの一覧を検索するように強制します。

構文

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

パラメーター

[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 の種類 意味
NULL
 NULL は、現在ログオンしているユーザーを表します。 現在のユーザー アカウントを参照する場合、szUserSID は NULL でき、dwContext MSIINSTALLCONTEXT_USERMANAGED または MSIINSTALLCONTEXT_USERUNMANAGEDできます。
ユーザー SID の
システム内の特定のユーザーの列挙を指定します。 ユーザー SID の例として、"S-1-3-64-2415071341-1358098788-3127455600-2561" があります。
 
注 特別な SID 文字列 "S-1-5-18" (システム) を使用して、コンピューターごとにインストールされている製品またはパッチを列挙することはできません。 SID 値を "S-1-5-18" に設定すると、ERROR_INVALID_PARAMETERが返されます。
 
注 特殊な SID 文字列 "S-1-1-0" (すべてのユーザー) は使用しないでください。 SID 値を "S-1-1-0" に設定すると失敗し、ERROR_INVALID_PARAMが返されます。
 

[in] dwContext

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

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

[in] dwOptions

dwOptions 値は、szProductCodeOrPatchCode 値の解釈とクリアするソースの種類を決定します。 このパラメーターは、次のいずれかの MSISOURCETYPE_ 定数と、次のいずれかの MSICODE_ 定数の組み合わせである必要があります。

旗 意味
MSISOURCETYPE_NETWORK
 ソースはネットワークの種類です。
MSISOURCETYPE_URL
 ソースは URL の種類です。
MSICODE_PRODUCT
 szProductCodeOrPatchCode は製品コードです。
MSICODE_PATCH
 szProductCodeOrPatchCode はパッチ コードです。

[in] szSource

削除するソース。 このパラメーターには、ファイル名のないパスのみが含まれている必要があります。 ファイル名は既に "PackageName" として登録されており、MsiSourceListSetInfoを使用して操作できます。 この引数は必須です。

戻り値

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

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

備考

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

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

手記

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

必要条件

要件 価値
サポートされる最小クライアント 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

関連項目

AllowLockdownBrowse の

AlwaysInstallElevated

DisableBrowse の

MsiSourceListSetInfo

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

ProductCode を する

ソースの回復性 の