GetFileVersionInfoExA-Funktion (winver.h)

Artikel
03/11/2023

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

Art: 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 wurden, 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, sofern verfügbar, und lädt die Binärversionsinformationen (VS_FIXEDFILEINFO) aus der entsprechenden sprachneutralen Datei, sofern verfügbar.
FILE_VER_GET_PREFETCHED 0x04	Gibt eine Einstellung für version.dll an, um zu versuchen, das Bild außerhalb der Ladesperre vorab zu laden, um Konflikte zu vermeiden. Dieses Flag ändert weder das Verhalten noch die Semantik der Funktion.

[in] lpwstrFilename

Typ: LPCTSTR

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

dwHandle

Art: DWORD

Dieser Parameter ist reserviert und wird als null (0) erwartet.

[in] dwLen

Art: DWORD

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

Rufen Sie zuerst die GetFileVersionInfoSizeEx-Funktion auf, um die Größe der Versionsinformationen einer Datei in Bytes zu bestimmen. 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ückgibt, enthält 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 fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Bemerkungen

Rufen Sie die GetFileVersionInfoSizeEx-Funktion auf, bevor Sie die GetFileVersionInfoEx-Funktion aufrufen. Um Informationen aus dem Dateiversionsinformationspuffer abzurufen, verwenden Sie die VerQueryValue-Funktion .

Hinweis

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 nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winver.h (Einschließen von Windows.h)
Bibliothek	Version.lib
DLL	Api-ms-win-core-version-l1-1-0.dll