SetupGetInfInformationA-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 SetUpGetInfInformation Funktion gibt die SP_INF_INFORMATION Struktur für die angegebene INF-Datei in einen Puffer zurück.
Syntax
WINSETUPAPI BOOL SetupGetInfInformationA(
[in] LPCVOID InfSpec,
[in] DWORD SearchControl,
[in, out] PSP_INF_INFORMATION ReturnBuffer,
[in] DWORD ReturnBufferSize,
[in, out] PDWORD RequiredSize
);
Parameter
[in] InfSpec
Behandeln 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 sie zusammen angefügt wurden. Wenn dies der Fall ist, enthält die von dieser Funktion zurückgegebene Struktur mehrere Informationssätze.
INFINFO_INF_NAME_IS_ABSOLUTE
Die für InfSpec- angegebene Zeichenfolge ist ein vollständiger Pfad. Für InfSpecwird keine weitere Verarbeitung durchgeführt.
INFINFO_DEFAULT_SEARCH
Durchsuchen Sie die Standardspeicherorte für die INF-Datei, die für InfSpec-angegeben ist. Dies wird nur als Dateiname angenommen. Die Standardspeicherorte sind %windir%\inf-, gefolgt von %windir%\system32.
INFINFO_REVERSE_DEFAULT_SEARCH
Identisch mit INFINFO_DEFAULT_SEARCH, außer dass die Standardspeicherorte in umgekehrter Reihenfolge durchsucht werden.
INFINFO_INF_PATH_LIST_SEARCH
Suchen Sie in den verzeichnissen, die in den DevicePath- Werteintrags aufgelistet sind, unter den folgendenHKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion
[in, out] ReturnBuffer
Zeigt nicht NULL-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 dann die Funktion ein zweites Mal aufzurufen, um die Daten abzurufen. Mithilfe dieser Technik können Sie Fehler aufgrund einer unzureichenden Puffergröße vermeiden. Weitere Informationen finden Sie im Abschnitt "Hinweise" dieses Themas.
[in] ReturnBufferSize
Größe ReturnBuffer-in Byte.
[in, out] RequiredSize
Wenn nicht NULL-, verweist sie auf eine Variable, in der diese Funktion die erforderliche Größe (in Byte) 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 Wert ungleich Null.
Wenn die Funktion fehlschlägt, ist der Rückgabewert 0 (null). Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.
Wenn die INF-Datei nicht gefunden werden kann, gibt die Funktion FALSE- und einen nachfolgenden Aufruf von GetLastError zurück, ERROR_FILE_NOT_FOUND zurück.
Bemerkungen
Wenn diese Funktion mit einem ReturnBuffer von NULL- und einer ReturnBufferSize von 0 (Null) aufgerufen wird, platziert die Funktion die Puffergröße, die zum Halten der angegebenen Daten in die Variable erforderlich ist, auf die von RequiredSize verwiesen wird. Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Wert ungleich Null. Andernfalls ist der Rückgabewert 0 (Null), und erweiterte Fehlerinformationen können durch Aufrufen von GetLastErrorabgerufen werden.
Anmerkung
Der Header setupapi.h definiert SetupGetInfInformation 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 |