GetFileVersionInfoA-Funktion (winver.h)

Artikel
11/20/2024

Ruft Versionsinformationen für die angegebene Datei ab.

Syntax

BOOL GetFileVersionInfoA(
  [in]  LPCSTR lptstrFilename,
        DWORD  dwHandle,
  [in]  DWORD  dwLen,
  [out] LPVOID lpData
);

Parameter

[in] lptstrFilename

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 wird ignoriert.

[in] dwLen

Typ: DWORD-

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

Rufen Sie zuerst die GetFileVersionInfoSize-Funktion auf, um die Größe der Versionsinformationen einer Datei in Bytes zu bestimmen. Der dwLen Member 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-

Zeigen Sie auf einen Puffer, der die Dateiversionsinformationen empfängt.

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

Dateiversionsinformationen haben feste und nicht feste Teile. Der feste Teil enthält Informationen wie die Versionsnummer. Der nicht feste Teil enthält Elemente wie Zeichenfolgen. In der Vergangenheit GetFileVersionInfo Versionsinformationen aus der Binärdatei (exe/dll) verwendet. Derzeit fragt es eine feste Version aus sprachneutraler Datei (exe/dll) und den nicht festen Teil aus der Mui-Datei ab, führt sie zusammen und kehrt zum Benutzer zurück. Wenn die angegebene Binärdatei nicht über eine Mui-Datei verfügt, ist das Verhalten wie in der vorherigen Version.

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

Anmerkung

Der winver.h-Header definiert GetFileVersionInfo 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 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	winver.h (enthalten Windows.h)
Library	Version.lib
DLL-	Api-ms-win-core-version-l1-1-0.dll