MsiSourceListForceResolutionW-Funktion (msi.h)
Die MsiSourceListForceResolution-Funktion erzwingt, dass der Installer die Quellliste nach einer gültigen Produktquelle durchsucht, wenn das nächste Mal eine Quelle erforderlich ist. Beispielsweise, wenn das Installationsprogramm eine Installation oder Neuinstallation durchführt oder wenn es den Pfad für eine Komponente benötigt, die von der Quelle aus ausgeführt werden soll.
Syntax
UINT MsiSourceListForceResolutionW(
[in] LPCWSTR szProduct,
[in] LPCWSTR szUserName,
[in] DWORD dwReserved
);
Parameter
[in] szProduct
Der ProductCode des zu ändernden Produkts.
[in] szUserName
Der Benutzername für eine Benutzerinstallation. Der Benutzername sollte immer im Format DOMAIN\USERNAME (oder MACHINENAME\USERNAME für einen lokalen Benutzer) vorliegen.
Eine leere Zeichenfolge oder NULL für eine Computerinstallation.
[in] dwReserved
Für die zukünftige Verwendung reserviert. Dieser Wert muss auf 0 festgelegt werden.
Rückgabewert
Die MsiSourceListForceResolution-Funktion gibt die folgenden Werte zurück.
Wert | Bedeutung |
---|---|
|
Der Aufrufer hat keinen ausreichenden Zugriff, um die Auflösung für das Produkt zu erzwingen. |
|
Die Konfigurationsdaten sind beschädigt. |
|
Der angegebene Benutzer ist kein gültiger Benutzer. |
|
Die Funktion konnte nicht abgeschlossen werden. |
|
Auf den Installationsdienst konnte nicht zugegriffen werden. |
|
Es wurde ein ungültiger Parameter an die Funktion übergeben. |
|
Die Funktion wurde erfolgreich ausgeführt. |
|
Das angegebene Produkt ist unbekannt. |
Hinweise
Ein Administrator kann computerspezifische Installationen, ihre eigenen nicht verwalteten Installationen pro Benutzer und die pro Benutzer verwalteten Installationen für jeden Benutzer ändern. Ein Nicht-Administrator kann nur computerspezifische Installationen und ihre eigenen (verwalteten oder nicht verwalteten) Installationen pro Benutzer ändern.
Wenn der Benutzername eine leere Zeichenfolge oder NULL ist, wird die Funktion für die computerspezifische Installation des Produkts ausgeführt. Wenn das Produkt in diesem Fall nur pro Benutzer installiert ist, gibt die Funktion ERROR_UNKNOWN_PRODUCT zurück.
Wenn der Benutzername keine leere Zeichenfolge oder NULL ist, wird der Name des Benutzers angegeben, dessen Produktinstallation geändert wurde. Wenn der Benutzername der aktuelle Benutzername ist, versucht die Funktion zunächst, eine nicht verwaltete Installation des Produkts zu ändern. Wenn keine nicht verwaltete Installation des Produkts gefunden wird, versucht die Funktion, eine verwaltete Installation des Produkts pro Benutzer zu ändern. Wenn keine verwalteten oder nicht verwalteten Benutzerinstallationen des Produkts gefunden werden können, gibt die Funktion ERROR_UNKNOWN_PRODUCT zurück, auch wenn das Produkt pro Computer installiert ist.
Diese Funktion kann eine nicht verwaltete Installation für keinen Benutzer außer dem aktuellen Benutzer ändern. Wenn der Benutzername keine leere Zeichenfolge oder NULL ist, aber nicht der aktuelle Benutzer ist, sucht die Funktion nur nach einer verwalteten Einzelbenutzerinstallation des Produkts für den angegebenen Benutzer. Wenn das Produkt nicht als verwaltet pro Benutzer für den angegebenen Benutzer installiert wird, gibt die Funktion ERROR_UNKNOWN_PRODUCT zurück, auch wenn das Produkt pro Computer installiert wird.
Hinweis
Der msi.h-Header definiert MsiSourceListForceResolution 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
Anforderung | Wert |
---|---|
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 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
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für