GetFileVersionInfoA-Funktion (winver.h)
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 |
Siehe auch
Konzept
Referenz