2 * Implementation of VERSION.DLL - Version Info access
4 * Copyright 1996,1997 Marcus Meissner
5 * Copyright 1997 David Cuthbert
6 * Copyright 1999 Ulrich Weigand
7 * Copyright 2005 Paul Vriens
9 * This library is free software; you can redistribute it and/or
10 * modify it under the terms of the GNU Lesser General Public
11 * License as published by the Free Software Foundation; either
12 * version 2.1 of the License, or (at your option) any later version.
14 * This library is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
17 * Lesser General Public License for more details.
19 * You should have received a copy of the GNU Lesser General Public
20 * License along with this library; if not, write to the Free Software
21 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
35 #include "wine/unicode.h"
37 #include "wine/debug.h"
39 WINE_DEFAULT_DEBUG_CHANNEL(ver
);
41 extern DWORD
find_version_resource( HFILE lzfd
, DWORD
*reslen
, DWORD
*offset
);
43 /******************************************************************************
45 * This function will print via standard TRACE, debug info regarding
46 * the file info structure vffi.
47 * 15-Feb-1998 Dimitrie Paun (dimi@cs.toronto.edu)
48 * Added this function to clean up the code.
50 *****************************************************************************/
51 static void print_vffi_debug(const VS_FIXEDFILEINFO
*vffi
)
53 BOOL versioned_printer
= FALSE
;
55 if((vffi
->dwFileType
== VFT_DLL
) || (vffi
->dwFileType
== VFT_DRV
))
57 if(vffi
->dwFileSubtype
== VFT2_DRV_VERSIONED_PRINTER
)
58 /* this is documented for newer w2k Drivers and up */
59 versioned_printer
= TRUE
;
60 else if( (vffi
->dwFileSubtype
== VFT2_DRV_PRINTER
) &&
61 (vffi
->dwFileVersionMS
!= vffi
->dwProductVersionMS
) &&
62 (vffi
->dwFileVersionMS
> 0) &&
63 (vffi
->dwFileVersionMS
<= 3) )
64 /* found this on NT 3.51, NT4.0 and old w2k Drivers */
65 versioned_printer
= TRUE
;
68 TRACE("structversion=%u.%u, ",
69 HIWORD(vffi
->dwStrucVersion
),LOWORD(vffi
->dwStrucVersion
));
72 WORD mode
= LOWORD(vffi
->dwFileVersionMS
);
73 WORD ver_rev
= HIWORD(vffi
->dwFileVersionLS
);
74 TRACE("fileversion=%u.%u.%u.%u (%s.major.minor.release), ",
75 (vffi
->dwFileVersionMS
),
76 HIBYTE(ver_rev
), LOBYTE(ver_rev
), LOWORD(vffi
->dwFileVersionLS
),
77 (mode
== 3) ? "Usermode" : ((mode
<= 2) ? "Kernelmode" : "?") );
81 TRACE("fileversion=%u.%u.%u.%u, ",
82 HIWORD(vffi
->dwFileVersionMS
),LOWORD(vffi
->dwFileVersionMS
),
83 HIWORD(vffi
->dwFileVersionLS
),LOWORD(vffi
->dwFileVersionLS
));
85 TRACE("productversion=%u.%u.%u.%u\n",
86 HIWORD(vffi
->dwProductVersionMS
),LOWORD(vffi
->dwProductVersionMS
),
87 HIWORD(vffi
->dwProductVersionLS
),LOWORD(vffi
->dwProductVersionLS
));
89 TRACE("flagmask=0x%x, flags=0x%x %s%s%s%s%s%s\n",
90 vffi
->dwFileFlagsMask
, vffi
->dwFileFlags
,
91 (vffi
->dwFileFlags
& VS_FF_DEBUG
) ? "DEBUG," : "",
92 (vffi
->dwFileFlags
& VS_FF_PRERELEASE
) ? "PRERELEASE," : "",
93 (vffi
->dwFileFlags
& VS_FF_PATCHED
) ? "PATCHED," : "",
94 (vffi
->dwFileFlags
& VS_FF_PRIVATEBUILD
) ? "PRIVATEBUILD," : "",
95 (vffi
->dwFileFlags
& VS_FF_INFOINFERRED
) ? "INFOINFERRED," : "",
96 (vffi
->dwFileFlags
& VS_FF_SPECIALBUILD
) ? "SPECIALBUILD," : "");
100 TRACE("OS=0x%x.0x%x ", HIWORD(vffi
->dwFileOS
), LOWORD(vffi
->dwFileOS
));
102 switch (vffi
->dwFileOS
&0xFFFF0000)
104 case VOS_DOS
:TRACE("DOS,");break;
105 case VOS_OS216
:TRACE("OS/2-16,");break;
106 case VOS_OS232
:TRACE("OS/2-32,");break;
107 case VOS_NT
:TRACE("NT,");break;
110 TRACE("UNKNOWN(0x%x),",vffi
->dwFileOS
&0xFFFF0000);break;
113 switch (LOWORD(vffi
->dwFileOS
))
115 case VOS__BASE
:TRACE("BASE");break;
116 case VOS__WINDOWS16
:TRACE("WIN16");break;
117 case VOS__WINDOWS32
:TRACE("WIN32");break;
118 case VOS__PM16
:TRACE("PM16");break;
119 case VOS__PM32
:TRACE("PM32");break;
121 TRACE("UNKNOWN(0x%x)",LOWORD(vffi
->dwFileOS
));break;
126 switch (vffi
->dwFileType
)
128 case VFT_APP
:TRACE("filetype=APP");break;
130 TRACE("filetype=DLL");
131 if(vffi
->dwFileSubtype
!= 0)
133 if(versioned_printer
) /* NT3.x/NT4.0 or old w2k Driver */
135 TRACE(" (subtype=0x%x)", vffi
->dwFileSubtype
);
139 TRACE("filetype=DRV,");
140 switch(vffi
->dwFileSubtype
)
142 case VFT2_DRV_PRINTER
:TRACE("PRINTER");break;
143 case VFT2_DRV_KEYBOARD
:TRACE("KEYBOARD");break;
144 case VFT2_DRV_LANGUAGE
:TRACE("LANGUAGE");break;
145 case VFT2_DRV_DISPLAY
:TRACE("DISPLAY");break;
146 case VFT2_DRV_MOUSE
:TRACE("MOUSE");break;
147 case VFT2_DRV_NETWORK
:TRACE("NETWORK");break;
148 case VFT2_DRV_SYSTEM
:TRACE("SYSTEM");break;
149 case VFT2_DRV_INSTALLABLE
:TRACE("INSTALLABLE");break;
150 case VFT2_DRV_SOUND
:TRACE("SOUND");break;
151 case VFT2_DRV_COMM
:TRACE("COMM");break;
152 case VFT2_DRV_INPUTMETHOD
:TRACE("INPUTMETHOD");break;
153 case VFT2_DRV_VERSIONED_PRINTER
:TRACE("VERSIONED_PRINTER");break;
156 TRACE("UNKNOWN(0x%x)",vffi
->dwFileSubtype
);break;
160 TRACE("filetype=FONT,");
161 switch (vffi
->dwFileSubtype
)
163 case VFT2_FONT_RASTER
:TRACE("RASTER");break;
164 case VFT2_FONT_VECTOR
:TRACE("VECTOR");break;
165 case VFT2_FONT_TRUETYPE
:TRACE("TRUETYPE");break;
166 default:TRACE("UNKNOWN(0x%x)",vffi
->dwFileSubtype
);break;
169 case VFT_VXD
:TRACE("filetype=VXD");break;
170 case VFT_STATIC_LIB
:TRACE("filetype=STATIC_LIB");break;
173 TRACE("filetype=Unknown(0x%x)",vffi
->dwFileType
);break;
177 TRACE("filedate=0x%x.0x%x\n",vffi
->dwFileDateMS
,vffi
->dwFileDateLS
);
180 /***********************************************************************
181 * Version Info Structure
189 #if 0 /* variable length structure */
193 VS_VERSION_INFO_STRUCT16 Children
[];
195 } VS_VERSION_INFO_STRUCT16
;
203 #if 0 /* variable length structure */
207 VS_VERSION_INFO_STRUCT32 Children
[];
209 } VS_VERSION_INFO_STRUCT32
;
211 #define VersionInfoIs16( ver ) \
212 ( ((const VS_VERSION_INFO_STRUCT16 *)ver)->szKey[0] >= ' ' )
214 #define DWORD_ALIGN( base, ptr ) \
215 ( (LPBYTE)(base) + ((((LPBYTE)(ptr) - (LPBYTE)(base)) + 3) & ~3) )
217 #define VersionInfo16_Value( ver ) \
218 DWORD_ALIGN( (ver), (ver)->szKey + strlen((ver)->szKey) + 1 )
219 #define VersionInfo32_Value( ver ) \
220 DWORD_ALIGN( (ver), (ver)->szKey + strlenW((ver)->szKey) + 1 )
222 #define VersionInfo16_Children( ver ) \
223 (const VS_VERSION_INFO_STRUCT16 *)( VersionInfo16_Value( ver ) + \
224 ( ( (ver)->wValueLength + 3 ) & ~3 ) )
225 #define VersionInfo32_Children( ver ) \
226 (const VS_VERSION_INFO_STRUCT32 *)( VersionInfo32_Value( ver ) + \
227 ( ( (ver)->wValueLength * \
228 ((ver)->wType? 2 : 1) + 3 ) & ~3 ) )
230 #define VersionInfo16_Next( ver ) \
231 (VS_VERSION_INFO_STRUCT16 *)( (LPBYTE)ver + (((ver)->wLength + 3) & ~3) )
232 #define VersionInfo32_Next( ver ) \
233 (VS_VERSION_INFO_STRUCT32 *)( (LPBYTE)ver + (((ver)->wLength + 3) & ~3) )
236 /***********************************************************************
237 * GetFileVersionInfoSizeW [VERSION.@]
239 DWORD WINAPI
GetFileVersionInfoSizeW( LPCWSTR filename
, LPDWORD handle
)
241 DWORD len
, offset
, magic
= 0;
246 TRACE("(%s,%p)\n", debugstr_w(filename
), handle
);
248 if (handle
) *handle
= 0;
252 SetLastError(ERROR_INVALID_PARAMETER
);
257 SetLastError(ERROR_BAD_PATHNAME
);
261 if ((lzfd
= LZOpenFileW( (LPWSTR
)filename
, &ofs
, OF_READ
)) != HFILE_ERROR
)
263 magic
= find_version_resource( lzfd
, &len
, &offset
);
266 else if ((hModule
= LoadLibraryExW( filename
, 0, LOAD_LIBRARY_AS_DATAFILE
)))
268 HRSRC hRsrc
= FindResourceW( hModule
, MAKEINTRESOURCEW(VS_VERSION_INFO
),
269 MAKEINTRESOURCEW(VS_FILE_INFO
) );
272 magic
= IMAGE_NT_SIGNATURE
;
273 len
= SizeofResource( hModule
, hRsrc
);
275 FreeLibrary( hModule
);
279 SetLastError( ofs
.nErrCode
);
285 case IMAGE_OS2_SIGNATURE
:
286 /* We have a 16bit resource.
288 * XP/W2K/W2K3 uses a buffer which is more than the actual needed space:
290 * (info->wLength - sizeof(VS_FIXEDFILEINFO)) * 4
292 * This extra buffer is used for ANSI to Unicode conversions in W-Calls.
293 * info->wLength should be the same as len. Currently it isn't but that
294 * doesn't seem to be a problem (len is bigger than info->wLength).
297 return (len
- sizeof(VS_FIXEDFILEINFO
)) * 4;
299 case IMAGE_NT_SIGNATURE
:
300 /* We have a 32bit resource.
302 * XP/W2K/W2K3 uses a buffer which is 2 times the actual needed space + 4 bytes "FE2X"
303 * This extra buffer is used for Unicode to ANSI conversions in A-Calls
306 return (len
* 2) + 4;
309 SetLastError(ERROR_RESOURCE_DATA_NOT_FOUND
);
314 /***********************************************************************
315 * GetFileVersionInfoSizeA [VERSION.@]
317 DWORD WINAPI
GetFileVersionInfoSizeA( LPCSTR filename
, LPDWORD handle
)
319 UNICODE_STRING filenameW
;
322 TRACE("(%s,%p)\n", debugstr_a(filename
), handle
);
325 RtlCreateUnicodeStringFromAsciiz(&filenameW
, filename
);
327 filenameW
.Buffer
= NULL
;
329 retval
= GetFileVersionInfoSizeW(filenameW
.Buffer
, handle
);
331 RtlFreeUnicodeString(&filenameW
);
336 /***********************************************************************
337 * GetFileVersionInfoW [VERSION.@]
339 BOOL WINAPI
GetFileVersionInfoW( LPCWSTR filename
, DWORD handle
,
340 DWORD datasize
, LPVOID data
)
342 static const char signature
[4] = "FE2X";
343 DWORD len
, offset
, magic
= 0;
347 VS_VERSION_INFO_STRUCT32
* vvis
= data
;
349 TRACE("(%s,%d,size=%d,data=%p)\n",
350 debugstr_w(filename
), handle
, datasize
, data
);
354 SetLastError(ERROR_INVALID_DATA
);
358 if ((lzfd
= LZOpenFileW( (LPWSTR
)filename
, &ofs
, OF_READ
)) != HFILE_ERROR
)
360 if ((magic
= find_version_resource( lzfd
, &len
, &offset
)))
362 LZSeek( lzfd
, offset
, 0 /* SEEK_SET */ );
363 len
= LZRead( lzfd
, data
, min( len
, datasize
) );
367 else if ((hModule
= LoadLibraryExW( filename
, 0, LOAD_LIBRARY_AS_DATAFILE
)))
369 HRSRC hRsrc
= FindResourceW( hModule
, MAKEINTRESOURCEW(VS_VERSION_INFO
),
370 MAKEINTRESOURCEW(VS_FILE_INFO
) );
373 HGLOBAL hMem
= LoadResource( hModule
, hRsrc
);
374 magic
= IMAGE_NT_SIGNATURE
;
375 len
= min( SizeofResource(hModule
, hRsrc
), datasize
);
376 memcpy( data
, LockResource( hMem
), len
);
377 FreeResource( hMem
);
379 FreeLibrary( hModule
);
383 SetLastError( ofs
.nErrCode
);
389 case IMAGE_OS2_SIGNATURE
:
390 /* We have a 16bit resource. */
392 print_vffi_debug( (VS_FIXEDFILEINFO
*)VersionInfo16_Value( (VS_VERSION_INFO_STRUCT16
*)data
));
396 case IMAGE_NT_SIGNATURE
:
397 /* We have a 32bit resource.
399 * XP/W2K/W2K3 uses a buffer which is 2 times the actual needed space + 4 bytes "FE2X"
400 * This extra buffer is used for Unicode to ANSI conversions in A-Calls
402 len
= vvis
->wLength
+ sizeof(signature
);
403 if (datasize
>= len
) memcpy( (char*)data
+ vvis
->wLength
, signature
, sizeof(signature
) );
405 print_vffi_debug( (VS_FIXEDFILEINFO
*)VersionInfo32_Value( vvis
));
410 SetLastError(ERROR_RESOURCE_DATA_NOT_FOUND
);
415 /***********************************************************************
416 * GetFileVersionInfoA [VERSION.@]
418 BOOL WINAPI
GetFileVersionInfoA( LPCSTR filename
, DWORD handle
,
419 DWORD datasize
, LPVOID data
)
421 UNICODE_STRING filenameW
;
424 TRACE("(%s,%d,size=%d,data=%p)\n",
425 debugstr_a(filename
), handle
, datasize
, data
);
428 RtlCreateUnicodeStringFromAsciiz(&filenameW
, filename
);
430 filenameW
.Buffer
= NULL
;
432 retval
= GetFileVersionInfoW(filenameW
.Buffer
, handle
, datasize
, data
);
434 RtlFreeUnicodeString(&filenameW
);
439 /***********************************************************************
440 * VersionInfo16_FindChild [internal]
442 static const VS_VERSION_INFO_STRUCT16
*VersionInfo16_FindChild( const VS_VERSION_INFO_STRUCT16
*info
,
443 LPCSTR szKey
, UINT cbKey
)
445 const VS_VERSION_INFO_STRUCT16
*child
= VersionInfo16_Children( info
);
447 while ((char *)child
< (char *)info
+ info
->wLength
)
449 if (!strncasecmp( child
->szKey
, szKey
, cbKey
) && !child
->szKey
[cbKey
])
452 if (!(child
->wLength
)) return NULL
;
453 child
= VersionInfo16_Next( child
);
459 /***********************************************************************
460 * VersionInfo32_FindChild [internal]
462 static const VS_VERSION_INFO_STRUCT32
*VersionInfo32_FindChild( const VS_VERSION_INFO_STRUCT32
*info
,
463 LPCWSTR szKey
, UINT cbKey
)
465 const VS_VERSION_INFO_STRUCT32
*child
= VersionInfo32_Children( info
);
467 while ((char *)child
< (char *)info
+ info
->wLength
)
469 if (!strncmpiW( child
->szKey
, szKey
, cbKey
) && !child
->szKey
[cbKey
])
472 if (!(child
->wLength
)) return NULL
;
473 child
= VersionInfo32_Next( child
);
479 /***********************************************************************
480 * VersionInfo16_QueryValue [internal]
482 * Gets a value from a 16-bit NE resource
484 static BOOL
VersionInfo16_QueryValue( const VS_VERSION_INFO_STRUCT16
*info
, LPCSTR lpSubBlock
,
485 LPVOID
*lplpBuffer
, UINT
*puLen
)
487 while ( *lpSubBlock
)
489 /* Find next path component */
491 for ( lpNextSlash
= lpSubBlock
; *lpNextSlash
; lpNextSlash
++ )
492 if ( *lpNextSlash
== '\\' )
495 /* Skip empty components */
496 if ( lpNextSlash
== lpSubBlock
)
502 /* We have a non-empty component: search info for key */
503 info
= VersionInfo16_FindChild( info
, lpSubBlock
, lpNextSlash
-lpSubBlock
);
506 if (puLen
) *puLen
= 0 ;
507 SetLastError( ERROR_RESOURCE_TYPE_NOT_FOUND
);
511 /* Skip path component */
512 lpSubBlock
= lpNextSlash
;
516 *lplpBuffer
= VersionInfo16_Value( info
);
518 *puLen
= info
->wValueLength
;
523 /***********************************************************************
524 * VersionInfo32_QueryValue [internal]
526 * Gets a value from a 32-bit PE resource
528 static BOOL
VersionInfo32_QueryValue( const VS_VERSION_INFO_STRUCT32
*info
, LPCWSTR lpSubBlock
,
529 LPVOID
*lplpBuffer
, UINT
*puLen
)
531 TRACE("lpSubBlock : (%s)\n", debugstr_w(lpSubBlock
));
533 while ( *lpSubBlock
)
535 /* Find next path component */
537 for ( lpNextSlash
= lpSubBlock
; *lpNextSlash
; lpNextSlash
++ )
538 if ( *lpNextSlash
== '\\' )
541 /* Skip empty components */
542 if ( lpNextSlash
== lpSubBlock
)
548 /* We have a non-empty component: search info for key */
549 info
= VersionInfo32_FindChild( info
, lpSubBlock
, lpNextSlash
-lpSubBlock
);
552 if (puLen
) *puLen
= 0 ;
553 SetLastError( ERROR_RESOURCE_TYPE_NOT_FOUND
);
557 /* Skip path component */
558 lpSubBlock
= lpNextSlash
;
562 *lplpBuffer
= VersionInfo32_Value( info
);
564 *puLen
= info
->wValueLength
;
569 /***********************************************************************
570 * VerQueryValueA [VERSION.@]
572 BOOL WINAPI
VerQueryValueA( LPCVOID pBlock
, LPCSTR lpSubBlock
,
573 LPVOID
*lplpBuffer
, PUINT puLen
)
575 static const char rootA
[] = "\\";
576 static const char varfileinfoA
[] = "\\VarFileInfo\\Translation";
577 const VS_VERSION_INFO_STRUCT16
*info
= pBlock
;
579 TRACE("(%p,%s,%p,%p)\n",
580 pBlock
, debugstr_a(lpSubBlock
), lplpBuffer
, puLen
);
585 if (lpSubBlock
== NULL
|| lpSubBlock
[0] == '\0')
588 if ( !VersionInfoIs16( info
) )
594 len
= MultiByteToWideChar(CP_ACP
, 0, lpSubBlock
, -1, NULL
, 0);
595 lpSubBlockW
= HeapAlloc(GetProcessHeap(), 0, len
* sizeof(WCHAR
));
600 MultiByteToWideChar(CP_ACP
, 0, lpSubBlock
, -1, lpSubBlockW
, len
);
602 ret
= VersionInfo32_QueryValue(pBlock
, lpSubBlockW
, lplpBuffer
, puLen
);
604 HeapFree(GetProcessHeap(), 0, lpSubBlockW
);
606 if (ret
&& strcasecmp( lpSubBlock
, rootA
) && strcasecmp( lpSubBlock
, varfileinfoA
))
608 /* Set lpBuffer so it points to the 'empty' area where we store
609 * the converted strings
611 LPSTR lpBufferA
= (LPSTR
)pBlock
+ info
->wLength
+ 4;
612 DWORD pos
= (LPCSTR
)*lplpBuffer
- (LPCSTR
)pBlock
;
614 len
= WideCharToMultiByte(CP_ACP
, 0, *lplpBuffer
, -1,
615 lpBufferA
+ pos
, info
->wLength
- pos
, NULL
, NULL
);
616 *lplpBuffer
= lpBufferA
+ pos
;
622 return VersionInfo16_QueryValue(info
, lpSubBlock
, lplpBuffer
, puLen
);
625 /***********************************************************************
626 * VerQueryValueW [VERSION.@]
628 BOOL WINAPI
VerQueryValueW( LPCVOID pBlock
, LPCWSTR lpSubBlock
,
629 LPVOID
*lplpBuffer
, PUINT puLen
)
631 static const WCHAR nullW
[] = { 0 };
632 static const WCHAR rootW
[] = { '\\', 0 };
633 static const WCHAR varfileinfoW
[] = { '\\','V','a','r','F','i','l','e','I','n','f','o',
634 '\\','T','r','a','n','s','l','a','t','i','o','n', 0 };
636 const VS_VERSION_INFO_STRUCT32
*info
= pBlock
;
638 TRACE("(%p,%s,%p,%p)\n",
639 pBlock
, debugstr_w(lpSubBlock
), lplpBuffer
, puLen
);
644 if (lpSubBlock
== NULL
|| lpSubBlock
[0] == nullW
[0])
647 if ( VersionInfoIs16( info
) )
653 len
= WideCharToMultiByte(CP_ACP
, 0, lpSubBlock
, -1, NULL
, 0, NULL
, NULL
);
654 lpSubBlockA
= HeapAlloc(GetProcessHeap(), 0, len
* sizeof(char));
659 WideCharToMultiByte(CP_ACP
, 0, lpSubBlock
, -1, lpSubBlockA
, len
, NULL
, NULL
);
661 ret
= VersionInfo16_QueryValue(pBlock
, lpSubBlockA
, lplpBuffer
, puLen
);
663 HeapFree(GetProcessHeap(), 0, lpSubBlockA
);
665 if (ret
&& strcmpiW( lpSubBlock
, rootW
) && strcmpiW( lpSubBlock
, varfileinfoW
))
667 /* Set lpBuffer so it points to the 'empty' area where we store
668 * the converted strings
670 LPWSTR lpBufferW
= (LPWSTR
)((LPSTR
)pBlock
+ info
->wLength
);
671 DWORD pos
= (LPCSTR
)*lplpBuffer
- (LPCSTR
)pBlock
;
672 DWORD max
= (info
->wLength
- sizeof(VS_FIXEDFILEINFO
)) * 4 - info
->wLength
;
674 len
= MultiByteToWideChar(CP_ACP
, 0, *lplpBuffer
, -1,
675 lpBufferW
+ pos
, max
/sizeof(WCHAR
) - pos
);
676 *lplpBuffer
= lpBufferW
+ pos
;
682 return VersionInfo32_QueryValue(info
, lpSubBlock
, lplpBuffer
, puLen
);