SetupQueryInfFileInformationW-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 SetupQueryInfFileInformation-Funktion gibt einen INF-Dateinamen von einer SP_INF_INFORMATION-Struktur in einen Puffer zurück.
Syntax
WINSETUPAPI BOOL SetupQueryInfFileInformationW(
[in] PSP_INF_INFORMATION InfInformation,
[in] UINT InfIndex,
[in, out] PWSTR ReturnBuffer,
[in] DWORD ReturnBufferSize,
[in, out] PDWORD RequiredSize
);
Parameter
[in] InfInformation
Zeiger auf eine SP_INF_INFORMATION Struktur, die von einem Aufruf der SetupGetInfInformation-Funktion zurückgegeben wird.
[in] InfIndex
Index des abzurufenden INF-Dateinamens. Dieser Index kann im Bereich [0, InfInformation.InfCount) liegen. Das bedeutet, dass infInformation.InfCount die Werte null bis, aber nicht enthalten, gültig sind.
[in, out] ReturnBuffer
Wenn nicht NULL, ist ReturnBuffer ein Zeiger auf einen Puffer, in dem diese Funktion den vollständigen INF-Dateinamen zurückgibt. Sie sollten eine NULL-Zeichenfolge verwenden. Die NULL-Zeichenfolge 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 die Funktion dann ein zweites Mal aufzurufen, um die Daten abzurufen. Weitere Informationen finden Sie im Abschnitt mit den Hinweisen. Mit diesem Verfahren können Sie Fehler aufgrund einer unzureichenden Puffergröße vermeiden. Dieser Parameter kann NULL sein.
[in] ReturnBufferSize
Größe des Puffers, auf den der ReturnBuffer-Parameter verweist, in Zeichen. Dies schließt den NULL-Abschlussator ein.
[in, out] RequiredSize
Wenn nicht NULL, zeigen Sie auf eine Variable, die die erforderliche Größe für den ReturnBuffer-Puffer in Zeichen empfängt. Dies schließt den NULL-Abschlussator ein. Wenn ReturnBuffer angegeben ist und die tatsächliche 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 null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Wenn diese Funktion mit einem ReturnBuffer von NULL und einer ReturnBufferSize von 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 in dieser Funktion erfolgreich ist, ist der Rückgabewert ein Nonzero-Wert. Andernfalls ist der Rückgabewert null, und erweiterte Fehlerinformationen können durch Aufrufen von GetLastError abgerufen werden.
Hinweis
Der setupapi.h-Header definiert SetupQueryInfFileInformation 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 |
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