SetupGetInfPublishedNameA-Funktion (setupapi.h)
Die SetupGetInfPublishedName-Funktion ruft den vollqualifizierten Dateinamen (Verzeichnispfad und Dateiname) einer INF-Datei im INF-Systemdateiverzeichnis ab, das einer angegebenen INF-Datei im Treiberspeicher oder einer angegebenen INF-Datei im System-INF-Dateiverzeichnis entspricht.
Syntax
WINSETUPAPI BOOL SetupGetInfPublishedNameA(
[in] PCSTR DriverStoreLocation,
[out] PSTR ReturnBuffer,
[in] DWORD ReturnBufferSize,
[out, optional] PDWORD RequiredSize
);
Parameter
[in] DriverStoreLocation
Ein Zeiger auf eine MIT NULL beendete Zeichenfolge, die den vollqualifizierten Dateinamen (Verzeichnispfad und Dateiname) einer INF-Datei im Treiberspeicher enthält. Alternativ ist dieser Parameter ein Zeiger auf eine MIT NULL beendete Zeichenfolge, die den Namen und optional den vollständigen Verzeichnispfad einer INF-Datei im System-INF-Dateiverzeichnis enthält. Weitere Informationen zum Angeben der INF-Datei finden Sie im folgenden abschnitt Hinweise.
[out] ReturnBuffer
Ein Zeiger auf den Puffer, in dem SetupGetInfPublishedName eine NULL-beendete Zeichenfolge zurückgibt, die den vollqualifizierten Dateinamen der angegebenen INF-Datei im System-INF-Verzeichnis enthält. Die maximale Pfadgröße ist MAX_PATH. Dieser Zeiger kann auf NULL-festgelegt werden. Informationen zum Ermitteln der erforderlichen Größe des Rückgabepuffers finden Sie im folgenden abschnitt Hinweise.
[in] ReturnBufferSize
Die Größe des von ReturnBuffer-bereitgestellten Puffers in Zeichen.
[out, optional] RequiredSize
Ein Zeiger auf eine DWORD-Typvariable, die die Größe des ReturnBuffer- Puffers in Zeichen empfängt. Dieser Parameter ist optional und kann auf NULL-festgelegt werden.
Rückgabewert
Wenn SetupGetInfPublishedName erfolgreich ist, gibt die Funktion TRUEzurück; andernfalls gibt die Funktion FALSEzurück. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.
Wenn die Größe des vollqualifizierten Dateinamens der angeforderten INF-Datei, einschließlich eines Null-Terminators, größer als ReturnBufferSizeist, schlägt die Funktion fehl, und ein Aufruf von GetLastError gibt ERROR_INSUFFICIENT_BUFFER zurück.
Bemerkungen
Um die Größe des Rückgabepuffers zu ermitteln, der erforderlich ist, um den vollqualifizierten Dateinamen der angegebenen INF-Datei im System-INF-Verzeichnis zu enthalten, rufen Sie SetupGetInfPublishedName auf, und legen Sie ReturnBuffer- auf NULL-fest, ReturnBufferSize null, und geben Sie RequiredSize-an. SetupGetInfPublishedName- gibt die erforderliche Puffergröße in RequiredSize-zurück.
Wenn die Geräteinstallation ein Treiberpaket im Treiberspeicher vorinstalliert, erstellt es zwei Kopien der INF-Datei des Treiberpakets. Die Geräteinstallation fügt dem System-INF-Verzeichnis eine Kopie hinzu und weist dieser Kopie der INF-Datei einen eindeutigen veröffentlichten Dateinamen des Formulars OEMnnn.infzu. Die Geräteinstallation fügt dem Treiberspeicher eine zweite Kopie der INF-Datei hinzu und weist diesem den ursprünglichen INF-Dateinamen zu.
SetupGetInfPublishedName den vollqualifizierten Dateinamen der INF-Datei im System-INF-Dateiverzeichnis zurück, das ggf. mit der INF-Datei übereinstimmt, die von DriverStoreLocationbereitgestellt wird. DriverStoreLocation- muss den vollqualifizierten Dateinamen einer INF-Datei im Treiberspeicher angeben oder den Dateinamen und optional den Verzeichnispfad einer INF-Datei im SYSTEM-INF-Verzeichnis angeben. Gehen Sie beispielsweise davon aus, dass die INF-Datei für ein Treiberpaket myinf.infist und dass die Geräteinstallation für dieses Treiberpaket die INF-Datei OEM1.inf im System-INF-Verzeichnis C:\Windows\infinstalliert. Gehen Sie außerdem davon aus, dass die Geräteinstallation die entsprechende INF-Dateikopie C:\windows\system32\driverstore\filerepository\myinf_12345678\myinf.inf im Treiberspeicher installiert. In diesem Fall: die Funktion gibt C:\Windows\inf\OEM1.inf zurück, wenn DriverStoreLocation eine der folgenden Zeichenfolgen bereitstellt: C:\windows\system32\driverstore\filerepository\myinf_12345678\myinf.inf, OEM1.infoder C:\Windows\inf\OEM1.inf.
Rufen Sie die funktion SetupGetInfDriverStoreLocation auf, um den vollqualifizierten Dateinamen einer INF-Datei im Treiberspeicher abzurufen, die einer angegebenen INF-Datei im System-INF-Dateiverzeichnis oder einer angegebenen Datei im Treiberspeicher entspricht.
Anmerkung
Der Header setupapi.h definiert SetupGetInfPublishedName 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- | Verfügbar in Windows Vista und höheren Versionen von Windows. |
| Zielplattform- | Desktop |
| Header- | setupapi.h (include Setupapi.h) |
| Library | Setupapi.lib |