GetFileVersionInfoSizeW-Funktion (winver.h)
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 Bytes zurück.
Syntax
DWORD GetFileVersionInfoSizeW(
[in] LPCWSTR lptstrFilename,
[out, optional] LPDWORD lpdwHandle
);
Parameter
[in] lptstrFilename
Typ: LPCTSTR
Der Name der relevanten Datei. Die Funktion verwendet die von der LoadLibrary-Funktion angegebene Suchsequenz.
[out, optional] lpdwHandle
Typ: LPDWORD
Ein Zeiger auf eine Variable, die die Funktion auf 0 (null) festlegt.
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 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 von GetFileVersionInfo zurückgegebenen Versionsinformationen erforderlich ist.
Hinweis
Der winver.h-Header definiert GetFileVersionInfoSize 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 2000 Professional [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows 2000 Server [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 |
Siehe auch
Konzept
Referenz