MsiSourceListClearSourceA-Funktion (msi.h)

Die MsiSourceListClearSource-Funktion entfernt eine vorhandene Quelle für ein Produkt oder Patch in einem bestimmten Kontext. Die Patchregistrierung wird auch entfernt, wenn die einzige Quelle des Patches entfernt wird und der Patch nicht von einem Client im selben Kontext installiert wird. Wenn Sie angeben, dass MsiSourceListClearSource die aktuelle Quelle für dieses Produkt entfernen oder patchen, erzwingt das Installationsprogramm, die Quellliste nach einer Quelle zu durchsuchen, wenn das nächste Mal eine Quelle erforderlich ist.

Syntax

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

Parameter

[in] szProductCodeOrPatchCode

Die ProductCode oder Patch-GUID des Produkts oder Patches. Verwenden Sie eine mit Null beendete Zeichenfolge. Wenn die Zeichenfolge länger als 39 Zeichen ist, schlägt die Funktion fehl und gibt ERROR_INVALID_PARAMETERzurück. Dieser Parameter kann nicht NULL-werden.

[in, optional] szUserSid

Dieser Parameter kann eine Zeichenfolgen-SID sein, die das Benutzerkonto angibt, das das Produkt oder den Patch enthält. Die SID wird nicht überprüft oder aufgelöst. Eine falsche SID kann ERROR_UNKNOWN_PRODUCT oder ERROR_UNKNOWN_PATCHzurückgeben. Beim Verweisen auf einen Computerkontext muss szUserSID-NULL- sein und dwContext-MSIINSTALLCONTEXT_MACHINEsein.

[in] dwContext

Dieser Parameter gibt den Kontext der Produkt- oder Patchinstanz an. Dieser Parameter kann einen der folgenden Werte enthalten.

[in] dwOptions

Der dwOptions Wert bestimmt die Interpretation des szProductCodeOrPatchCode Werts und den zu löschenden Quellentyp. Dieser Parameter muss eine Kombination aus einer der folgenden MSISOURCETYPE_ Konstanten und einer der folgenden MSICODE_ Konstanten sein.

[in] szSource

Quelle, die entfernt werden soll. Dieser Parameter wird erwartet, dass er nur den Pfad ohne dateinamen enthält. Der Dateiname ist bereits als "PackageName" registriert und kann über MsiSourceListSetInfobearbeitet werden. Dieses Argument ist erforderlich.

Rückgabewert

Die MsiSourceListClearSource-funktion gibt die folgenden Werte zurück.

Bemerkungen

Administratoren können die Installation eines Produkts oder einer Patchinstanz ändern, die im Computerkontext oder im eigenen Benutzerkontext vorhanden ist (verwaltet oder nicht verwaltet).) Sie können die Installation eines Produkts oder einer Patchinstanz ändern, die im vom Benutzer verwalteten Kontext vorhanden ist. Administratoren können die Installation eines Produkts oder einer Patchinstanz eines anderen Benutzers nicht ändern, die im kontextbasierten Kontext eines anderen Benutzers vorhanden ist.

Nicht-Administratoren können die Installation eines Produkts oder einer Patchinstanz nicht ändern, die im Benutzerkontext eines anderen Benutzers vorhanden ist (verwaltet oder nicht verwaltet.) Sie können die Installation eines Produkts oder einer Patchinstanz ändern, die unter ihrem eigenen benutzerspezifischen nicht verwalteten Kontext vorhanden ist. Sie können die Installation eines Produkts oder einer Patchinstanz im Computerkontext oder in ihrem eigenen vom Benutzer verwalteten Kontext nur ändern, wenn sie für die Suche nach einer Produkt- oder Patchquelle aktiviert sind. Benutzer können aktiviert werden, um nach Quellen zu suchen, indem Sie eine Richtlinie festlegen. Weitere Informationen finden Sie unter DisableBrowse, AllowLockdownBrowseund AlwaysInstallElevated Richtlinien.

Anforderungen

Siehe auch

AllowLockdownBrowse-

AlwaysInstallElevated

DisableBrowse-

MsiSourceListSetInfo-

in Windows Installer 2.0 und früheren nicht unterstützt

ProductCode-

Quellresilienz-