GetFileVersionInfoSizeExA-Funktion (winver.h)

Artikel
11/20/2024

Bestimmt, ob das Betriebssystem Versionsinformationen für eine angegebene Datei abrufen kann. Wenn Versionsinformationen verfügbar sind, gibt GetFileVersionInfoSizeEx die Größe dieser Informationen in Bytes zurück.

Syntax

DWORD GetFileVersionInfoSizeExA(
  [in]            DWORD   dwFlags,
  [in]            LPCSTR  lpwstrFilename,
  [out, optional] LPDWORD lpdwHandle
);

Parameter

[in] dwFlags

Typ: DWORD-

Steuert, welche MUI-DLLs (falls vorhanden) aus der Versionsressource extrahiert werden. 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 0x002	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.

[in] lpwstrFilename

Typ: LPCTSTR-

Der Name der datei von Interesse. Die Funktion verwendet die durch die LoadLibrary-Funktion angegebene Suchsequenz.

[out, optional] lpdwHandle

Typ: LPDWORD-

Wenn diese Funktion zurückgegeben wird, enthält sie einen Zeiger auf eine Variable, die auf Null festgelegt ist, da diese Funktion sie auf Null festlegt. Dieser Parameter ist aus historischen Gründen vorhanden.

Rückgabewert

Typ: DWORD-

Wenn die Funktion erfolgreich ist, ist der Rückgabewert die Größe der Versionsinformationen der Datei in Bytes.

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. Die von GetFileVersionInfoSizeEx zurückgegebene Größe gibt die puffergröße an, die für die versionsinformationen erforderlich ist, die von GetFileVersionInfoExzurückgegeben werden.

Anmerkung

Der winver.h-Header definiert GetFileVersionInfoSizeEx 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