The VerQueryValue function returns selected version information from the specified version-information resource. To retrieve the appropriate resource, before you call VerQueryValue, you must first call the GetFileVersionInfoSize function, and then the GetFileVersionInfo function.
As with the other file installation functions, VerQueryValue works only with Win32 file images. It does not work with 16-bit Windows file images.
BOOL VerQueryValue(
const LPVOID pBlock, |
// address of buffer for version resource |
LPTSTR lpSubBlock, |
// address of value to retrieve |
LPVOID *lplpBuffer, |
// address of buffer for version value pointer |
PUINT puLen |
// address of length buffer |
); |
Form |
Description |
\ |
Specifies the root block. The function retrieves a pointer to the VS_FIXEDFILEINFO structure for the version-information resource. |
\VarFileInfo\Translation |
Specifies the translation array in a Var variable information structure. The function retrieves a pointer to an array of language and code page identifiers. An application can use these identifiers to access a language-specific StringTable structure in the version-information resource. |
\StringFileInfo\lang-codepage\string-name |
Specifies a value in a language-specific StringTable structure. The lang-codepage name is a concatenation of a language and code page identifier pair found as a DWORD in the translation array for the resource. Here the lang-codepage name must be specified as a hexadecimal string. The string-name name must be one of the predefined strings described in the following Remarks section. The function retrieves a string value specific to the language and code page indicated. |
If the specified version-information structure exists, and version information is available, the return value is nonzero. If the address of the length buffer is zero, no value is available for the specified version-information name.
If the specified name does not exist or the specified resource is not valid, the return value is zero.
The Win32 API contains the following predefined version information Unicode strings:
CompanyName FileDescription FileVersion InternalName LegalCopyright OriginalFilename ProductName ProductVersion Comments LegalTrademarks PrivateBuild SpecialBuild
The following example shows how to retrieve the FileDescription string-value from a block of version information, if the language is U.S. English and the code page is Windows Multilingual:
VerQueryValue(pBlock, TEXT("\\StringFileInfo\\040904E4\\FileDescription"), &lpBuffer, &dwBytes);
Call the GetFileVersionInfoSize and GetFileVersionInfo functions before calling the VerQueryValue function to properly initialize the pBlock buffer.
GetFileVersionInfo, VarFileInfo, Var, StringFileInfo, StringTable, String, GetFileVersionInfoSize, VS_FIXEDFILEINFO, VS_VERSION_INFO
file: /Techref/os/win/api/win32/func/src/f90_7.htm, 6KB, , updated: 2008/4/17 23:37, local time: 2024/12/25 12:02,
52.15.113.71:LOG IN
|
©2024 These pages are served without commercial sponsorship. (No popup ads, etc...).Bandwidth abuse increases hosting cost forcing sponsorship or shutdown. This server aggressively defends against automated copying for any reason including offline viewing, duplication, etc... Please respect this requirement and DO NOT RIP THIS SITE. Questions? <A HREF="http://massmind.org/Techref/os/win/api/win32/func/src/f90_7.htm"> VerQueryValue</A> |
Did you find what you needed? |
Welcome to massmind.org! |
Welcome to massmind.org! |
.