SetupQuerySourceListW-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.]

Die SetupQuerySourceList-Funktion fragt die aktuelle Liste der Installationsquellen ab. Die Liste basiert auf system- und benutzerspezifischen Listen und kann durch eine temporäre Liste überschrieben werden (siehe SetupSetSourceList).

Syntax

WINSETUPAPI BOOL SetupQuerySourceListW(
  [in]      DWORD  Flags,
  [in, out] PCWSTR **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

Abfrage der Benutzerliste.

Hinweis Wenn das System und die Benutzerlisten beide 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 endgültige Komponente handelt. Beispielsweise wird ein in der Registrierung gespeicherter Pfad als f:\x86 als f:\x86 zurückgegeben. Wenn dieses Flag angegeben ist, 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 mit Null beendete Zeichenfolge. Der Aufrufer muss dieses Array mit einem Aufruf von SetupFreeSourceListfreigeben.

[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 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 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 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