MsiSourceListAddSourceW-Funktion (msi.h)

Artikel
08/24/2023

Die MsiSourceListAddSource-Funktion fügt der Liste der gültigen Netzwerkquellen hinzu, die den angegebenen Typ von Quellen für ein Produkt oder einen Patch in einem angegebenen Benutzerkontext enthalten.

Die Anzahl der Quellen in der SOURCELIST-Eigenschaft ist unbegrenzt.

Syntax

UINT MsiSourceListAddSourceW(
  [in] LPCWSTR szProduct,
  [in] LPCWSTR szUserName,
  [in] DWORD   dwReserved,
  [in] LPCWSTR szSource
);

Parameter

[in] szProduct

Der ProductCode des zu ändernden Produkts.

[in] szUserName

Der Benutzername für eine Benutzerinstallation. Unter Windows 2000 oder Windows XP sollte der Benutzername immer das Format DOMÄNE\BENUTZERNAME (oder COMPUTERNAME\BENUTZERNAME für einen lokalen Benutzer) aufweisen.

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.

[in] szSource

Verweis auf die Zeichenfolge, die die Quelle angibt.

Rückgabewert

Rückgabecode	Beschreibung
ERROR_ACCESS_DENIED	Der Benutzer kann keine Quelle hinzufügen.
ERROR_BAD_CONFIGURATION	Die Konfigurationsdaten sind beschädigt.
ERROR_BAD_USERNAME	Der Benutzername konnte nicht aufgelöst werden.
ERROR_FUNCTION_FAILED	Die Funktion war nicht erfolgreich.
ERROR_INSTALL_SERVICE_FAILURE	Auf den Installationsdienst konnte nicht zugegriffen werden.
ERROR_INVALID_PARAMETER	Es wurde ein ungültiger Parameter an die Funktion übergeben.
ERROR_SUCCESS	Die Quelle wurde hinzugefügt.
ERROR_UNKNOWN_PRODUCT	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. Benutzer können aktiviert werden, um nach Quellen zu suchen, indem Sie eine Richtlinie festlegen. Weitere Informationen finden Sie unter den Richtlinien DisableBrowse, AllowLockdownBrowse und AlwaysInstallElevated .

Beachten Sie, dass diese Funktion lediglich die neue Quelle der Liste der gültigen Quellen hinzufügt. Wenn zum Installieren des Produkts eine andere Quelle verwendet wurde, wird die neue Quelle erst verwendet, wenn die aktuelle Quelle nicht verfügbar ist.

Es liegt in der Verantwortung des Aufrufers sicherzustellen, dass die bereitgestellte Quelle ein gültiges Quellimage für das Produkt ist.

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 im Status pro Benutzer installiert wird, 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 MsiSourceListAddSource 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