MsiSourceListClearAllA 関数 (msi.h)
MsiSourceListClearAll 関数は、指定されたコンテキストでパッチまたは製品のソース リストからすべてのネットワーク ソースを削除します。 詳細については、「ソースの回復性
構文
UINT MsiSourceListClearAllA(
[in] LPCSTR szProduct,
[in] LPCSTR szUserName,
[in] DWORD dwReserved
);
パラメーター
[in] szProduct
変更する製品の ProductCode。
[in] szUserName
ユーザーごとのインストールのユーザー名。 ユーザー名は常に DOMAIN\USERNAME (またはローカル ユーザーの場合は MACHINENAME\USERNAME) の形式にする必要があります。
マシンごとのインストールの空の文字列または NULL。
[in] dwReserved
将来の使用のために予約されています。 この値は 0 に設定する必要があります。
戻り値
MsiSourceListClearAll 関数は、次の値を返します。
価値 | 意味 |
---|---|
|
ユーザーには、この製品のソース リストをクリアする機能がありません。 |
|
構成データが破損しています。 |
|
ユーザー名を解決できませんでした。 |
|
関数が成功しませんでした。 |
|
インストーラー サービスにアクセスできませんでした。 |
|
無効なパラメーターが関数に渡されました。 |
|
関数は成功しました。 |
|
指定された製品が不明です。 |
備考
管理者は、任意のユーザーのマシンごとのインストール、ユーザーごとの独自の非管理インストール、およびユーザーごとの管理インストールを変更できます。 管理者以外のユーザーは、マシンごとのインストールと、ユーザーごとの独自の (マネージドまたは非マネージドの) インストールのみを変更できます。 ユーザーは、ポリシーを設定してソースを参照できます。 詳細については、
ネットワーク ソースが製品の現在のソースである場合、この関数は、次にソースが必要になった場合に、インストーラーに強制的にソース 一覧で有効なソースを検索させます。 現在のソースがメディアまたは URL ソースの場合、この呼び出し後も有効であり、msiSourceListForceResolution
ユーザー名が空の文字列または NULL
ユーザー名が空の文字列ではない場合、または NULL
この関数は、現在のユーザー以外のユーザーに対して管理されていないインストールを変更することはできません。 ユーザー名が空の文字列または NULLではなく、現在のユーザーでない場合、関数は指定されたユーザーの製品のマネージド ユーザーごとのインストールのみを確認します。 指定したユーザーに対して製品がユーザーごとの管理対象としてインストールされていない場合、この関数は、製品がマシンごとにインストールされている場合でも、ERROR_UNKNOWN_PRODUCTを返します。
手記
msi.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして MsiSourceListClearAll を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
要件 | 価値 |
---|---|
サポートされる最小クライアント | 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 インストーラー。 Windows インストーラーのバージョンで必要な最小 Windows Service Pack の詳細については、Windows インストーラーの Run-Time 要件を参照してください。 |
ターゲット プラットフォーム の |
ウィンドウズ |
ヘッダー | msi.h |
ライブラリ | Msi.lib |
DLL | Msi.dll |
関連項目
AllowLockdownBrowse の
DisableBrowse の
ProductCode を
ソースの回復性 の