GetFileVersionInfoSize

The GetFileVersionInfoSize function determines whether the operating system can obtain version information about a specified file. If version information is available, GetFileVersionInfoSize returns the size, in bytes, of that information.

As with other file installation functions, GetFileVersionInfoSize works only with Win32 file images. It does not work with 16-bit Windows file images.

DWORD GetFileVersionInfoSize(
  LPTSTR lptstrFilename,  // pointer to filename string
  LPDWORD lpdwHandle      // pointer to variable to receive zero
);
 

Parameters

lptstrFilename
Pointer to a null-terminated filename string that specifies the file of interest.

Windows 95 and Windows 98: The short path form of the specified file name must be less than 126 characters.

lpdwHandle
Pointer to a variable that the function sets to zero.

Return Values

If the function succeeds, the return value is the size, in bytes, of the file's version information.

If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

Call the GetFileVersionInfoSize function before calling the GetFileVersionInfo function. The size returned by GetFileVersionInfoSize indicates the buffer size required for the version information returned by GetFileVersionInfo.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in winver.h.
  Import Library: Use version.lib.
  Unicode: Implemented as Unicode and ANSI versions on Windows NT.

See Also

File Installation Library Overview, File Installation Library Functions, GetFileVersionInfo, VS_VERSIONINFO, VerQueryValue