GetFileVersionInfoSizeExA-Funktion (winver.h)

Artikel
03/13/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

Art: DWORD

Steuert, aus welchen MUI-DLLs (falls vorhanden) die Versionsressource extrahiert 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 0x002	Lädt die Versionsressourcenzeichenfolgen aus der entsprechenden MUI-Datei, sofern verfügbar, und lädt die binären Versionsinformationen (VS_FIXEDFILEINFO) aus der entsprechenden sprachneutralen Datei, sofern verfügbar.

[in] lpwstrFilename

Typ: LPCTSTR

Der Name der relevanten Datei. Die Funktion verwendet die von der LoadLibrary-Funktion angegebene Suchsequenz.

[out, optional] lpdwHandle

Typ: LPDWORD

Wenn diese Funktion zurückgibt, enthält einen Zeiger auf eine Variable, die auf 0 festgelegt ist, da diese Funktion sie auf 0 (null) festlegt. Dieser Parameter ist aus historischen Gründen vorhanden.

Rückgabewert

Art: DWORD

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

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

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 von GetFileVersionInfoEx zurückgegebenen Versionsinformationen erforderlich ist.

Hinweis

Der winver.h-Header definiert GetFileVersionInfoSizeEx 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
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winver.h (windows.h einschließen)
Bibliothek	Version.lib
DLL	Api-ms-win-core-version-l1-1-0.dll