SetupGetInfInformationW-Funktion (setupapi.h)
[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 SetUpGetInfInformation-Funktion gibt die SP_INF_INFORMATION-Struktur für die angegebene INF-Datei an einen Puffer zurück.
Syntax
WINSETUPAPI BOOL SetupGetInfInformationW(
[in] LPCVOID InfSpec,
[in] DWORD SearchControl,
[in, out] PSP_INF_INFORMATION ReturnBuffer,
[in] DWORD ReturnBufferSize,
[in, out] PDWORD RequiredSize
);
Parameter
[in] InfSpec
Handle oder einen Dateinamen für eine INF-Datei, abhängig vom Wert von SearchControl.
[in] SearchControl
Dieser Parameter kann eine der folgenden Konstanten sein.
INFINFO_INF_SPEC_IS_HINF
InfSpec ist ein INF-Handle. Ein einzelnes INF-Handle kann auf mehrere INF-Dateien verweisen, wenn diese aneinander angefügt wurden. Wenn dies der Fall ist, enthält die von dieser Funktion zurückgegebene Struktur mehrere Sätze von Informationen.
INFINFO_INF_NAME_IS_ABSOLUTE
Die für InfSpec angegebene Zeichenfolge ist ein vollständiger Pfad. Auf InfSpec wird keine weitere Verarbeitung durchgeführt.
INFINFO_DEFAULT_SEARCH
Suchen Sie die Standardspeicherorte nach der für InfSpec angegebenen INF-Datei, wobei angenommen wird, dass es sich nur um einen Dateinamen handelt. Die Standardspeicherorte sind %windir%\inf, gefolgt von %windir%\system32.
INFINFO_REVERSE_DEFAULT_SEARCH
Identisch mit INFINFO_DEFAULT_SEARCH, mit der Ausnahme, dass die Standardspeicherorte in umgekehrter Reihenfolge durchsucht werden.
INFINFO_INF_PATH_LIST_SEARCH
Suchen Sie nach dem INF in jedem der Verzeichnisse, die im DevicePath-Werteintrag unter folgendem Eintrag aufgeführt sind:HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion
[in, out] ReturnBuffer
Wenn nicht NULL, zeigt auf einen Puffer, in dem diese Funktion die SP_INF_INFORMATION-Struktur zurückgibt.
Sie können die Funktion einmal aufrufen, um die erforderliche Puffergröße abzurufen, den erforderlichen Arbeitsspeicher zuzuweisen und die Funktion dann ein zweites Mal aufzurufen, um die Daten abzurufen. Mit diesem Verfahren können Sie Fehler aufgrund einer unzureichenden Puffergröße vermeiden. Weitere Informationen finden Sie in diesem Thema im Abschnitt „Hinweise“.
[in] ReturnBufferSize
Größe von ReturnBuffer in Bytes.
[in, out] RequiredSize
Wenn nicht NULL, verweist auf eine Variable, in der diese Funktion die erforderliche Größe (in Bytes) für den Puffer zurückgibt, auf den ReturnBuffer verweist.
Wenn ReturnBuffer angegeben ist und die erforderliche Größe größer als ReturnBufferSize 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 Nichtzero-Wert.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert 0 (null). Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Wenn die INF-Datei nicht gefunden werden kann, gibt die Funktion FALSE zurück, und ein anschließender Aufruf von GetLastError gibt ERROR_FILE_NOT_FOUND zurück.
Hinweise
Wenn diese Funktion mit einem ReturnBuffer von NULL und einer ReturnBufferSize von 0 (null) aufgerufen wird, legt die Funktion die Puffergröße, die zum Halten der angegebenen Daten erforderlich ist, in die Variable ein, auf die von RequiredSize verwiesen wird. Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Nichtzero-Wert. Andernfalls ist der Rückgabewert 0 (null), und erweiterte Fehlerinformationen können durch Aufrufen von GetLastError abgerufen werden.
Hinweis
Der setupapi.h-Header definiert SetupGetInfInformation 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 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
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 |
Siehe auch
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für