SetupGetInfPublishedNameW-Funktion (setupapi.h)

Die SetupGetInfPublishedName-Funktion ruft den vollqualifizierten Dateinamen (Verzeichnispfad und Dateiname) einer INF-Datei im System-INF-Dateiverzeichnis ab, die einer angegebenen INF-Datei im Treiberspeicher oder einer angegebenen INF-Datei im System-INF-Dateiverzeichnis entspricht.

Syntax

WINSETUPAPI BOOL SetupGetInfPublishedNameW(
  [in]            PCWSTR DriverStoreLocation,
  [out]           PWSTR  ReturnBuffer,
  [in]            DWORD  ReturnBufferSize,
  [out, optional] PDWORD RequiredSize
);

Parameter

[in] DriverStoreLocation

Ein Zeiger auf eine NULL-endende Zeichenfolge, die den vollqualifizierten Dateinamen (Verzeichnispfad und Dateiname) einer INF-Datei im Treiberspeicher enthält. Alternativ ist dieser Parameter ein Zeiger auf eine NULL-endende 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 Bestimmen 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 Variable vom Typ DWORD, 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 TRUE zurück. Andernfalls gibt die Funktion FALSE zurück. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen zu erhalten.

Wenn die Größe des vollqualifizierten Dateinamens der angeforderten INF-Datei( einschließlich eines NULL-Abschlusszeichens) in Zeichen größer als ReturnBufferSize ist, schlägt die Funktion fehl, und ein Aufruf von GetLastError gibt ERROR_INSUFFICIENT_BUFFER zurück.

Hinweise

Um die Größe des Rückgabepuffers zu bestimmen, der den vollqualifizierten Dateinamen der angegebenen INF-Datei im System-INF-Verzeichnis enthalten muss, rufen Sie SetupGetInfPublishedName auf, legen Sie ReturnBuffer auf NULL, ReturnBufferSize auf Null fest, und geben Sie RequiredSize an. SetupGetInfPublishedName gibt die erforderliche Puffergröße in RequiredSize zurück.

Wenn bei der Geräteinstallation ein Treiberpaket im Treiberspeicher vorinstalliert wird, werden zwei Kopien der INF-Datei des Treiberpakets erstellt. Bei der Geräteinstallation wird dem Inf-Systemverzeichnis eine Kopie hinzugefügt und dieser Kopie der INF-Datei ein eindeutiger veröffentlichter Dateiname im Format OEMnnn.inf zugewiesen. Die Geräteinstallation fügt dem Treiberspeicher eine zweite Kopie der INF-Datei hinzu und weist diesem den ursprünglichen INF-Dateinamen zu.

SetupGetInfPublishedName gibt den vollqualifizierten Dateinamen der INF-Datei im System-INF-Dateiverzeichnis zurück, das ggf. mit der von DriverStoreLocation bereitgestellten INF-Datei übereinstimmt. 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. Angenommen, die INF-Datei für ein Treiberpaket lautet myinf.inf, und für dieses Treiberpaket installiert die Geräteinstallation die INF-Datei OEM1.inf im System-INF-Verzeichnis C:\Windows\inf. Angenommen, die Geräteinstallation installiert die entsprechende INF-Dateikopie C:\windows\system32\driverstore\filerepository\myinf_12345678\myinf.inf im Treiberspeicher. In diesem Fall gibt die Funktion C:\Windows\inf\OEM1.inf zurück, wenn DriverStoreLocation eine der folgenden Zeichenfolgen bereitstellt: C:\windows\system32\driverstore\filerepository\myinf_12345678\myinf.inf, OEM1.inf oder C:\Windows\inf\OEM1.inf.

Rufen Sie die SetupGetInfDriverStoreLocation-Funktion 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.

Hinweis

Der Setupapi.h-Header 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
Unterstützte Mindestversion (Client)	Verfügbar in Windows Vista und späteren Windows-Versionen.
Zielplattform	Desktop
Kopfzeile	setupapi.h (schließen Sie Setupapi.h ein)
Bibliothek	Setupapi.lib

Weitere Informationen

SetupGetInfDriverStoreLocation