SetupGetSourceInfoA-Funktion (setupapi.h)
[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 SetupGetSourceInfo Funktion ruft den Pfad, die Tagdatei oder die Medienbeschreibung für eine InF-Datei aufgeführte Quelle ab.
Syntax
WINSETUPAPI BOOL SetupGetSourceInfoA(
[in] HINF InfHandle,
[in] UINT SourceId,
[in] UINT InfoDesired,
[in, out] PSTR ReturnBuffer,
[in] DWORD ReturnBufferSize,
[in, out] PDWORD RequiredSize
);
Parameter
[in] InfHandle
Handle to an open INF file that contains a SourceDisksNames section. Wenn plattformspezifische Abschnitte für das System des Benutzers vorhanden sind (z. B. SourceDisksNames.x86), wird der plattformspezifische Abschnitt verwendet.
[in] SourceId
Bezeichner für ein Quellmedium. Dieser Wert wird verwendet, um nach Schlüsseln im Abschnitt SourceDisksNames zu suchen.
[in] InfoDesired
Gibt an, welche Informationen gewünscht werden. Pro Funktionsaufruf kann nur ein Wert angegeben werden, der nicht kombiniert werden kann. Die folgenden Informationstypen können aus einem SourceDisksNames Abschnitt abgerufen werden.
SRCINFO_PATH
Der pfad, der für die Quelle angegeben ist. Dies ist kein vollständiger Pfad, sondern der Pfad relativ zum Installationsstamm.
SRCINFO_TAGFILE
Die Tagdatei, die die Quellmedien identifiziert, oder wenn Cabs verwendet werden, den Namen der CAB-Datei.
SRCINFO_DESCRIPTION
Eine Beschreibung für die Medien.
[in, out] ReturnBuffer
Optionaler Zeiger auf einen Puffer, um die abgerufenen Informationen zu empfangen. Pfadrückkehrer sind garantiert nicht enden mit . Sie sollten eine null--terminated-Zeichenfolge verwenden. Die null-terminated string sollte die Größe des Zielpuffers nicht überschreiten. Sie können die Funktion einmal aufrufen, um die erforderliche Puffergröße abzurufen, den erforderlichen Arbeitsspeicher zuzuweisen und dann die Funktion ein zweites Mal aufzurufen, um die Daten abzurufen. Weitere Informationen finden Sie im Abschnitt "Hinweise". Mithilfe dieser Technik können Sie Fehler aufgrund einer unzureichenden Puffergröße vermeiden. Dieser Parameter kann NULL-sein.
[in] ReturnBufferSize
Die Größe des Puffers, auf den ReturnBuffer-in Zeichen verweist. Dies schließt den null Terminator ein.
[in, out] RequiredSize
Optionaler Zeiger auf eine Variable, die die erforderliche Größe für den durch ReturnBufferangegebenen Puffer in Zeichen empfängt. Dies schließt den null Terminator ein. Wenn ReturnBuffer- angegeben ist und die tatsächliche Größe größer als der von ReturnBufferSizeangegebene Wert ist, schlägt die Funktion fehl, und ein Aufruf von GetLastError- gibt ERROR_INSUFFICIENT_BUFFER zurück.
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
Wenn diese Funktion mit einer ReturnBuffer- von NULL- und einer ReturnBufferSize- null aufgerufen wird, fügt die Funktion die Puffergröße ein, die zum Halten der angegebenen Daten in die Variable erforderlich ist, auf die RequiredSizeverweist. Wenn die Funktion in diesem Fall erfolgreich ausgeführt wird, ist der Rückgabewert ein Wert ungleich Null. Andernfalls ist der Rückgabewert null und erweiterte Fehlerinformationen können durch Aufrufen von GetLastErrorabgerufen werden.
Anmerkung
Der Header setupapi.h definiert SetupGetSourceInfo 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 |