GetFileVersionInfoExA-Funktion (winver.h)

Artikel
11/20/2024

Ruft Versionsinformationen für die angegebene Datei ab.

Syntax

BOOL GetFileVersionInfoExA(
  [in]  DWORD  dwFlags,
  [in]  LPCSTR lpwstrFilename,
        DWORD  dwHandle,
  [in]  DWORD  dwLen,
  [out] LPVOID lpData
);

Parameter

[in] dwFlags

Typ: DWORD-

Steuert die MUI-DLLs (falls vorhanden), aus denen die Versionsressource extrahiert wird. Der Wert dieses Flags muss mit den Flags übereinstimmen, die an den entsprechenden GetFileVersionInfoSizeEx-aufruf übergeben werden, der verwendet wurde, um die Puffergröße zu bestimmen, die im dwLen-Parameter übergeben wird. Null oder mehr der folgenden Flags.

Wert	Bedeutung
FILE_VER_GET_LOCALISED 0x01	Lädt die gesamte Versionsressource (sowohl Zeichenfolgen als auch Binärversionsinformationen) aus der entsprechenden MUI-Datei, sofern verfügbar.
FILE_VER_GET_NEUTRAL 0x02	Lädt die Versionsressourcenzeichenfolgen aus der entsprechenden MUI-Datei, falls verfügbar, und lädt die Informationen zur binären Version (VS_FIXEDFILEINFO) aus der entsprechenden sprachneutralen Datei, falls verfügbar.
FILE_VER_GET_PREFETCHED 0x04	Gibt eine Voreinstellung für version.dll an, um zu versuchen, das Bild außerhalb der Ladesperre vorab zu laden, um einen Inhalt zu vermeiden. Dieses Kennzeichen ändert das Verhalten oder die Semantik der Funktion nicht.

[in] lpwstrFilename

Typ: LPCTSTR-

Der Name der Datei. Wenn kein vollständiger Pfad angegeben wird, verwendet die Funktion die durch die LoadLibrary-Funktion angegebene Suchsequenz.

dwHandle

Typ: DWORD-

Dieser Parameter ist reserviert und muss null (0) sein.

[in] dwLen

Typ: DWORD-

Die Größe des Puffers in Bytes, auf den der lpData--Parameter verweist.

Rufen Sie zuerst die funktion GetFileVersionInfoSizeEx auf, um die Größe der Versionsinformationen einer Datei in Bytes zu ermitteln. Der dwLen-Parameter sollte gleich oder größer als dieser Wert sein.

Wenn der puffer, auf den lpData verweist, nicht groß genug ist, schneidet die Funktion die Versionsinformationen der Datei auf die Größe des Puffers ab.

[out] lpData

Typ: LPVOID-

Wenn diese Funktion zurückgegeben wird, enthält sie einen Zeiger auf einen Puffer, der die Dateiversionsinformationen enthält.

Sie können diesen Wert in einem nachfolgenden Aufruf der VerQueryValue--Funktion verwenden, um Daten aus dem Puffer abzurufen.

Rückgabewert

Typ: BOOL-

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlschlägt, ist der Rückgabewert null. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.

Bemerkungen

Rufen Sie die GetFileVersionInfoSizeEx--Funktion auf, bevor Sie die GetFileVersionInfoEx--Funktion aufrufen. Verwenden Sie zum Abrufen von Informationen aus dem Dateiversionsinformationspuffer die VerQueryValue--Funktion.

Anmerkung

Der winver.h-Header definiert GetFileVersionInfoEx als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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 Vista [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2008 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	winver.h (enthalten Windows.h)
Library	Version.lib
DLL-	Api-ms-win-core-version-l1-1-0.dll