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

Siehe auch

SetupGetInfDriverStoreLocation-