GetFileVersionInfo
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