VerInfo.h

Go to the documentation of this file.

//~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
// Project: uLib - User mode utility library.
// Module: Fetch and display version data from VERSION resource.
// Author: Copyright (c) Love Nystrom
// License: NNOSL (BSD descendant, see NNOSL.txt in the base directory).
//~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

#ifndef __VersionBox_h_incl__
#define __VersionBox_h_incl__

#include <uLib/Common.h>

BEGIN_EXTERN_C

//+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
//+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

typedef void (__stdcall *PFnEnumVerStr)( CSTR Name, CSTR Val, PVOID UserData );


UINT EnumVersionStrings( PVOID vInfo, PFnEnumVerStr Action, PVOID UserData );


int AboutVerBox( HWND hOwner, LPCWSTR Caption, CSTR FName DEF_(NULL) );

//~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
// Easy access to version resource data.
//~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~


PVOID GetVersionResource( HMODULE hMod, CSTR ResId, PUINT pSize );


PVOID LoadVersionInfo( CSTR FName, PDWORD pSize );
PVOID FreeVersionInfo( PVOID vInfo ); 


CSTR  GetFixedVersionStr( IN PVOID vInfo );

#if 0 

CSTR  GetVersionStr( IN PVOID vInfo, IN CSTR BlockId, IN CSTR Name );
#endif


UINT GetVersionString(
    IN PVOID VerBuf, IN CSTR BlockId, IN CSTR Name, OUT TSTR Buffer, IN UINT BufLen
    );

//==---------------------------------------------------------------------------
// Some common version strings that are usually present..
//==---------------------------------------------------------------------------

CCSTR  V_ProdName  = _T("ProductName");
CCSTR  V_ProdVer   = _T("ProductVersion");
CCSTR  V_Copyright = _T("LegalCopyright");
CCSTR  V_Company   = _T("CompanyName");
CCSTR  V_Descript  = _T("FileDescription");
CCSTR  V_Comments  = _T("Comments");

//==---------------------------------------------------------------------------
//==---------------------------------------------------------------------------

#pragma pack( push,2 )
typedef struct _viXlt
{
    WORD  Lang; 
    WORD  Cp;   
}
VXLT, *PVXLT;
#pragma pack( pop )


bool GetVerTranslations( IN PVOID vInfo, OUT PVXLT* ppXlt, OUT PUINT pCount );


CSTR  GetVerTranslationStr( IN PVOID vInfo );

// Two predefined common translations

CCSTR V_EnUniBlock   = _T("040904B0");  
CCSTR V_EnMultiBlock = _T("040904E4");  

//~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
END_EXTERN_C
#endif//ndef __VersionBox_h_incl__
// EOF