The GetFileVersionInfo function returns version information about a specified file.
As with other file installation functions, GetFileVersionInfo works only with Win32 file images. It does not work with 16-bit Windows file images.
BOOL GetFileVersionInfo(
| LPTSTR lptstrFilename, | // pointer to filename string |
| DWORD dwHandle, | // ignored |
| DWORD dwLen, | // size of buffer |
| LPVOID lpData | // pointer to buffer to receive file-version info. |
| ); |
Parameters
lptstrFilename
Pointer to a null-terminated filename string that specifies the file of interest.
dwHandle
This parameter is ignored.
dwLen
Specifies the size, in bytes, of the buffer pointed to by lpData.
Call the GetFileVersionInfoSize function to determine the size in bytes of a file's version information. dwLen 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
Pointer to a buffer to receive file-version information.
You can use this value in a subsequent call to the VerQueryValue function.
The file version information is always in Unicode format.
Return Values
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.
See Also