GetFileVersionInfoSizeA-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 GetFileVersionInfoSize die Größe dieser Informationen in Byte zurück.

Syntax

DWORD GetFileVersionInfoSizeA(
  [in]            LPCSTR  lptstrFilename,
  [out, optional] LPDWORD lpdwHandle
);

Parameter

[in] lptstrFilename

Typ: LPCTSTR-

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

[out, optional] lpdwHandle

Typ: LPDWORD-

Ein Zeiger auf eine Variable, die von der Funktion auf Null festgelegt wird.

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 GetFileVersionInfoSize-Funktion auf, bevor Sie die GetFileVersionInfo-Funktion aufrufen. Die von GetFileVersionInfoSize zurückgegebene Größe gibt die Puffergröße an, die für die versionsinformationen erforderlich ist, die von GetFileVersionInfozurückgegeben werden.

Anmerkung

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