SetupQueryInfOriginalFileInformationW-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 SetupQueryInfOriginalFileInformation Funktion gibt den ursprünglichen Namen einer OEM-INF-Datei zurück.
Syntax
WINSETUPAPI BOOL SetupQueryInfOriginalFileInformationW(
[in] PSP_INF_INFORMATION InfInformation,
[in] UINT InfIndex,
[in] PSP_ALTPLATFORM_INFO AlternatePlatformInfo,
[out] PSP_ORIGINAL_FILE_INFO_W OriginalFileInfo
);
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 sich im Bereich [0, InfInformation.InfCount) befinden. Dies bedeutet, dass die Werte null bis einschließlich, aber nicht einschließen, InfInformation.InfCount- gültig sind.
[in] AlternatePlatformInfo
Optionaler Zeiger auf eine SP_ALTPLATFORM_INFO_V1- oder SP_ALTPLATFORM_INFO_V2-Struktur, mit der Informationen für eine alternative Plattform an SetupQueryInfOriginalFileInformationübergeben werden.
[out] OriginalFileInfo
Zeigen Sie auf eine SP_ORIGINAL_FILE_INFO Struktur, die den ursprünglichen INF-Dateinamen und die Katalogdateiinformationen empfängt, die von SetupQueryInfOriginalFileInformationzurückgegeben werden.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Wert ungleich Null.
Wenn die Funktion fehlschlägt, ist der Rückgabewert null. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.
Bemerkungen
Anmerkung
Der Header setupapi.h definiert SetupQueryInfOriginalFileInformation 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 |