GetFileVersionInfoA-Funktion (winver.h)

Artikel
08/28/2023

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 Suchsequenz, die von der LoadLibrary-Funktion angegeben wird.

dwHandle

Art: DWORD

Konvertiert die Zeichenfolgendarstellung einer Zahl in einem angegebenen Stil und einem kulturspezifischen Format in die entsprechende 32-Bit-Ganzzahl mit Vorzeichen.

[in] dwLen

Art: DWORD

Die Größe des Puffers in Bytes, auf die 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

Zeiger 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 fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Dateiversionsinformationen haben einen festen und nicht festen Teil. Der fixe Teil enthält Informationen wie versionsnummer. Der nicht feste Teil enthält Dinge wie Zeichenfolgen. In der Vergangenheit hat GetFileVersionInfo Versionsinformationen aus der Binärdatei (exe/dll) übernommen. Derzeit wird eine feste Version aus der sprachneutralen Datei (exe/dll) und dem nicht festen Teil aus der mui-Datei abgefragt, zusammengeführt und an den Benutzer zurückgegeben. Wenn die angegebene Binärdatei keine mui-Datei aufweist, verhält es sich wie in der vorherigen Version.

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

Hinweis

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 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

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [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