SetupQuerySourceListA-Funktion (setupapi.h)

Artikel
03/06/2024

[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 für die Installation von Anwendungen verwendet werden. Verwenden Sie stattdessen den Windows Installer zum Entwickeln von Anwendungsinstallationsprogrammen. SetupAPI wird weiterhin zum Installieren von Gerätetreibern verwendet.]

Die SetupQuerySourceList-Funktion fragt die aktuelle Liste der Installationsquellen ab. Die Liste wird aus den system- und benutzerspezifischen Listen erstellt und möglicherweise von einer temporären Liste überschrieben (siehe SetupSetSourceList).

Syntax

WINSETUPAPI BOOL SetupQuerySourceListA(
  [in]      DWORD Flags,
  [in, out] PCSTR **List,
  [in, out] PUINT Count
);

Parameter

[in] Flags

Gibt an, welche Liste abfragt werden soll. Dieser Parameter kann eine beliebige Kombination der folgenden Werte sein.

SRCLIST_SYSTEM

Fragen Sie die Systemliste ab.

SRCLIST_USER

Fragen Sie die Liste pro Benutzer ab.

Hinweis Wenn das System und die Benutzerlisten abgerufen werden, werden sie mit den Elementen in der Systemliste zusammengeführt, die zuerst angezeigt werden.

Hinweis Wenn keines der vorherigen Flags angegeben ist, wird die gesamte aktuelle (zusammengeführte) Liste zurückgegeben.

SRCLIST_NOSTRIPPLATFORM

Normalerweise werden alle Pfade einer plattformspezifischen Komponente entfernt, wenn es sich um die letzte Komponente handelt. Beispielsweise wird ein pfad, der in der Registrierung als f:\x86 gespeichert ist, als f:zurückgegeben. Wenn dieses Flag angegeben wird, wird die plattformspezifische Komponente nicht entfernt.

[in, out] List

Zeiger auf eine Variable, in der diese Funktion einen Zeiger auf ein Array von Quellen zurückgibt. Verwenden Sie eine NULL-Zeichenfolge. Der Aufrufer muss dieses Array mit einem Aufruf von SetupFreeSourceList freigeben.

[in, out] Count

Zeiger auf eine Variable, in der diese Funktion die Anzahl der Quellen in der Liste zurückgibt.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Nichtzero-Wert.

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 SetupQuerySourceList 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 nicht codierungsneutralem Code 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 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