MsiSourceListForceResolutionExA-Funktion (msi.h)

Artikel
08/24/2023

Die MsiSourceListForceResolutionEx-Funktion entfernt die Registrierung der Eigenschaft mit dem Namen "LastUsedSource". Diese Funktion wirkt sich nicht auf die registrierte Quellliste aus. Wenn das Installationsprogramm die Quelle zum erneuten Installieren eines Produkts oder Patches benötigt, versucht es zuerst die als "LastUsedSource" registrierte Quelle. Wenn dies fehlschlägt oder diese Registrierung fehlt, durchsucht das Installationsprogramm die anderen registrierten Quellen, bis eine gültige Quelle gefunden wird oder die Liste der Quellen erschöpft ist. Das Löschen der Registrierung "LastUsedSource" erzwingt, dass das Installationsprogramm eine Quellauflösung für die registrierten Quellen vorgibt, wenn die Quelle das nächste Mal benötigt wird.

Syntax

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

Parameter

[in] szProductCodeOrPatchCode

Die ProductCode - oder Patch-GUID des Produkts oder Patches. Verwenden Sie eine NULL-endende Zeichenfolge. Wenn die Zeichenfolge länger als 39 Zeichen ist, schlägt die Funktion fehl und gibt ERROR_INVALID_PARAMETER zurück. Dieser Parameter darf nicht NULL sein.

[in, optional] szUserSid

Bei diesem Parameter kann es sich um eine Zeichenfolgen-SID handeln, 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_PATCH zurückgeben. Beim Verweisen auf einen Computerkontext muss szUserSIDNULL und dwContext MSIINSTALLCONTEXT_MACHINE sein. Mithilfe der Computer-SID ("S-1-5-18") wird ERROR_INVALID PARAMETER zurückgegeben. Beim Verweisen auf das aktuelle Benutzerkonto kann szUserSIDNULL und dwContext MSIINSTALLCONTEXT_USERMANAGED oder MSIINSTALLCONTEXT_USERUNMANAGED sein.

[in] dwContext

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

Typ des Kontexts	Bedeutung
MSIINSTALLCONTEXT_USERMANAGED	Das Produkt oder der Patch instance ist im benutzerseitig verwalteten Kontext vorhanden.
MSIINSTALLCONTEXT_USERUNMANAGED	Das Produkt oder der Patch instance ist im benutzerspezifischen nicht verwalteten Kontext vorhanden.
MSIINSTALLCONTEXT_MACHINE	Das Produkt oder der Patch instance ist im Kontext pro Computer vorhanden.

[in] dwOptions

Der dwOptions-Wert bestimmt die Interpretation des szProductCodeOrPatchCode-Werts .

Flag	Bedeutung
MSICODE_PRODUCT	szProductCodeOrPatchCode ist ein Produktcode.
MSICODE_PATCH	szProductCodeOrPatchCode ist ein Patchcode.

Rückgabewert

Die MsiSourceListForceResolutionEx-Funktion gibt die folgenden Werte zurück.

Wert	Bedeutung
ERROR_ACCESS_DENIED	Der Benutzer kann die angegebene Quellliste nicht ändern. Gibt nicht an, ob das Produkt oder patch gefunden wurde.
ERROR_BAD_CONFIGURATION	Die Konfigurationsdaten sind beschädigt.
ERROR_INSTALL_SERVICE_FAILURE	Zugriff auf den Windows Installer-Dienst nicht
ERROR_INVALID_PARAMETER	Es wurde ein ungültiger Parameter an die Funktion übergeben.
ERROR_SUCCESS	Die Registrierung "LastUsedSource" wurde gelöscht.
ERROR_UNKNOWN_PATCH	Der Patch wurde nicht gefunden.
ERROR_UNKNOWN_PRODUCT	Das angegebene Produkt oder Patch wurde nicht gefunden.
ERROR_FUNCTION_FAILED	Unerwarteter interner Fehler.

Hinweise

Administratoren können die Installation eines Produkts oder eines Patch-instance ändern, das im Computerkontext oder unter ihrem eigenen Benutzerkontext (verwaltet oder nicht verwaltet) vorhanden ist. Sie können die Installation eines Produkts oder eines Patch-instance ändern, der im benutzerspezifischen verwalteten Kontext eines Benutzers vorhanden ist. Administratoren können die Installation eines Produkts oder eines Patch-instance eines anderen Benutzers, der unter dem benutzerspezifischen nicht verwalteten Kontext des anderen Benutzers vorhanden ist, nicht ändern.

Nicht-Administratoren können die Installation eines Produkts oder eines Patch-instance nicht ändern, der im Benutzerkontext eines anderen Benutzers (verwaltet oder nicht verwaltet) vorhanden ist. Sie können die Installation eines Produkts oder eines Patches instance ändern, das unter ihrem eigenen benutzerspezifischen nicht verwalteten Kontext vorhanden ist. Sie können die Installation eines Produkts oder Patch-instance unter dem Computerkontext oder ihrem eigenen benutzerseitig verwalteten Kontext nur ändern, wenn sie für die Suche nach einem Produkt oder einer Patchquelle aktiviert sind. Benutzer können durch Festlegen der Richtlinie zum Suchen nach Quellen aktiviert werden. Weitere Informationen finden Sie unter DisableBrowse, AllowLockdownBrowse und AlwaysInstallElevated .

Hinweis

Der msi.h-Header definiert MsiSourceListForceResolutionEx als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Installer 5.0 unter Windows Server 2012, Windows 8, Windows Server 2008 R2 oder Windows 7. Windows Installer 4.0 oder Windows Installer 4.5 unter Windows Server 2008 oder Windows Vista. Windows Installer 3.0 oder höher unter Windows Server 2003 oder Windows XP. Informationen zum mindestens erforderlichen Windows Service Pack für eine Windows Installer-Version finden Sie unter Windows Installer – Laufzeitanforderungen.
Zielplattform	Windows
Kopfzeile	msi.h
Bibliothek	Msi.lib
DLL	Msi.dll

Weitere Informationen

In Windows Installer 2.0 und früher nicht unterstützt

ProductCode

Quellenresilienz

Share via