SetupSetSourceListW-Funktion (setupapi.h)

Artikel
11/20/2024

[Diese Funktion steht für die Verwendung in den im Abschnitt "Anforderungen" angegebenen Betriebssystemen zur Verfügung. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein. SetupAPI sollte nicht mehr für die Installation von Anwendungen verwendet werden. Verwenden Sie stattdessen den Windows Installer zum Entwickeln von Anwendungsinstallationsprogrammen. SetupAPI wird weiterhin für die Installation von Gerätetreibern verwendet.]

Mit der SetupSetSourceList--Funktion kann der Aufrufer die Liste der Installationsquellen für den aktuellen Benutzer oder das System festlegen (allgemein für alle Benutzer).

Syntax

WINSETUPAPI BOOL SetupSetSourceListW(
  [in] DWORD  Flags,
  [in] PCWSTR *SourceList,
  [in] UINT   SourceCount
);

Parameter

[in] Flags

Gibt den Listentyp an. Dieser Parameter kann eine Kombination aus den folgenden Werten sein.

SRCLIST_SYSTEM

Die Liste ist die Liste pro System, die in der Registrierung gespeichert ist. Der Anrufer muss Mitglied der lokalen Administratorgruppe sein.

SRCLIST_USER

Die Liste ist die benutzerspezifische MRU-Liste, die in der Registrierung gespeichert ist.

SRCLIST_TEMPORARY

Die angegebene Liste ist temporär und ist die einzige Liste, auf die der aktuelle Prozess zugegriffen werden kann, bis SetupCancelTemporarySourceList aufgerufen wird oder SetSourceList- erneut aufgerufen wird.

Wichtig Wenn eine temporäre Liste festgelegt ist, werden Quellen nicht aus dem System oder benutzerlisten hinzugefügt oder gelöscht, auch wenn nachfolgende Aufrufe von SetupAddToSourceList oder SetupRemoveFromSourceList explizit diese Listen angeben.

Note One of the SRCLIST_SYSTEM, SRCLIST_USER, or SRCLIST_TEMPORARY flags must be specified.

SRCLIST_NOBROWSE

Der Benutzer darf keine Quellen hinzufügen oder ändern, wenn SetupPromptForDisk- verwendet wird. Dieses Kennzeichen wird in der Regel in Kombination mit dem SRCLIST_TEMPORARY-Flag verwendet.

[in] SourceList

Zeigen Sie auf ein Array von Zeichenfolgen, die als Quellliste verwendet werden sollen, wie durch den parameter Flags angegeben.

[in] SourceCount

Die Anzahl der Elemente im Array, auf die durch SourceList-verwiesen wird.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Wert ungleich Null.

Wenn die Funktion fehlschlägt, ist der Rückgabewert null. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.

Bemerkungen

Anmerkung

Der Header setupapi.h definiert SetupSetSourceList als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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
mindestens unterstützte Client-	Windows XP [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	setupapi.h
Library	Setupapi.lib
DLL-	Setupapi.dll