Retrieves version information for the specified file.
Syntax
BOOL WINAPI GetFileVersionInfo( _In_ LPCTSTR lptstrFilename, _Reserved_ DWORD dwHandle, _In_ DWORD dwLen, _Out_ LPVOID lpData );
Parameters
- lptstrFilename [in]
Type: LPCTSTR
The name of the file. If a full path is not specified, the function uses the search sequence specified by the LoadLibrary function.
- dwHandle
Type: DWORD
This parameter is ignored.
- dwLen [in]
Type: DWORD
The size, in bytes, of the buffer pointed to by the lpData parameter.
Call the GetFileVersionInfoSize function first to determine the size, in bytes, of a file's version information. The dwLen member should be equal to or greater than that value.
If the buffer pointed to by lpData is not large enough, the function truncates the file's version information to the size of the buffer.
- lpData [out]
Type: LPVOID
Pointer to a buffer that receives the file-version information.
You can use this value in a subsequent call to the VerQueryValue function to retrieve data from the buffer.
Return value
Type: BOOL
If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero. To get extended error information, call GetLastError.
Remarks
File version info has fixed and non-fixed part. The fixed part contains information like version number. The non-fixed part contains things like strings. In the past GetFileVersionInfo was taking version information from the binary (exe/dll). Currently, it is querying fixed version from language neutral file (exe/dll) and the non-fixed part from mui file, merges them and returns to the user. If the given binary does not have a mui file then behavior is as in previous version.
Call the GetFileVersionInfoSize function before calling the GetFileVersionInfo function. To retrieve information from the file-version information buffer, use the VerQueryValue function.
Requirements
Minimum supported client | Windows 2000 Professional [desktop apps only] |
---|---|
Minimum supported server | Windows 2000 Server [desktop apps only] |
Header |
|
Library |
|
DLL |
|
Unicode and ANSI names | GetFileVersionInfoW (Unicode) and GetFileVersionInfoA (ANSI) |
See also
- Reference
- GetFileVersionInfoSize
- VerQueryValue
- VS_VERSIONINFO
- Conceptual
- Version Information
- ///1286.
'VisualStudio.C++.C# > 코딩팁,함수활용,단편' 카테고리의 다른 글
GetWindowsDirectory. (0) | 2017.04.16 |
---|---|
VerQueryValue. (0) | 2017.04.15 |
Getting the System Version. (0) | 2017.04.15 |
GetSystemInfo. (0) | 2017.04.15 |
WM_USER, WM_APP. 메시지 번호 범위 용도. (0) | 2017.04.06 |
댓글