SetupAddToSourceListA-Funktion (setupapi.h)

Artikel
08/26/2023

[Diese Funktion ist für die Verwendung in den betriebssystemen verfügbar, die im Abschnitt "Anforderungen" angegeben sind. Es kann in nachfolgenden Versionen geändert oder entfernt werden. SetupAPI sollte nicht mehr zum Installieren von Anwendungen verwendet werden. Verwenden Sie stattdessen den Windows Installer zum Entwickeln von Installationsprogrammen für Anwendungen. SetupAPI wird weiterhin zum Installieren von Gerätetreibern verwendet.]

Die SetupAddToSourceList-Funktion fügt einen Wert an die Liste der Installationsquellen für den aktuellen Benutzer oder das System an. Wenn der Wert bereits vorhanden ist, wird er zuerst entfernt, sodass keine doppelten Einträge erstellt werden.

Ein Aufrufer dieser Funktion muss über Administratorrechte verfügen, andernfalls schlägt die Funktion fehl.

Syntax

WINSETUPAPI BOOL SetupAddToSourceListA(
  [in] DWORD Flags,
  [in] PCSTR Source
);

Parameter

[in] Flags

Liste, an die die Quelle angefügt wird. Dieser Parameter kann eine beliebige Kombination der folgenden Werte sein.

SRCLIST_SYSTEM

Fügen Sie die Quelle der Systemliste hinzu. Der Aufrufer muss ein Administrator sein.

SRCLIST_USER

Fügen Sie die Quelle der Liste pro Benutzer hinzu.

SRCLIST_SYSIFADMIN

Wenn der Aufrufer ein Administrator ist, wird die Quelle der Systemliste hinzugefügt. Wenn der Aufrufer kein Mitglied der lokalen Administratorgruppe ist, wird die Quelle der Benutzerliste für den aktuellen Benutzer hinzugefügt.

Hinweis Wenn derzeit eine temporäre Liste verwendet wird (siehe SetupSetSourceList), werden die vorherigen Flags ignoriert, und die Quelle wird der temporären Liste hinzugefügt.

SRCLIST_APPEND

Fügen Sie die Quelle am Ende der Liste hinzu. Wenn dieses Flag nicht angegeben ist, wird die Quelle am Anfang der Liste hinzugefügt.

[in] Source

Zeiger auf die Quelle, die der Liste hinzugefügt werden soll. Sie sollten eine NULL-endende Zeichenfolge verwenden.

Rückgabewert

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

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Hinweis

Der Setupapi.h-Header definiert SetupAddToSourceList 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 XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	setupapi.h
Bibliothek	Setupapi.lib
DLL	Setupapi.dll