utils.h File Reference

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Macros
#define	LoadResourceString(hInst, uID)    LoadResourceStringEx((hInst), (uID), NULL)
#define	LoadConditionalResourceString(hInst, bCond, uIDifT, uIDifF)    LoadConditionalResourceStringEx((hInst), (bCond), (uIDifT), (uIDifF), NULL)
#define	MONITOR_CENTER   0x0001
#define	MONITOR_CLIP   0x0000
#define	MONITOR_WORKAREA   0x0002
#define	MONITOR_AREA   0x0000

Functions
BOOL	MemFree (IN PVOID lpMem)
PVOID	MemAlloc (IN DWORD dwFlags, IN SIZE_T dwBytes)
LPWSTR	FormatDateTime (IN LPSYSTEMTIME pDateTime)
VOID	FreeDateTime (IN LPWSTR lpszDateTime)
LPWSTR	LoadResourceStringEx (IN HINSTANCE hInstance, IN UINT uID, OUT size_t *pSize OPTIONAL)
LPWSTR	LoadConditionalResourceStringEx (IN HINSTANCE hInstance, IN BOOL bCondition, IN UINT uIDifTrue, IN UINT uIDifFalse, IN size_t *pSize OPTIONAL)
DWORD	RunCommand (IN LPCWSTR lpszCommand, IN LPCWSTR lpszParameters, IN INT nShowCmd)
VOID	ClipOrCenterRectToMonitor (LPRECT prc, UINT flags)
VOID	ClipOrCenterWindowToMonitor (HWND hWnd, UINT flags)
BOOL	IsWindowsOS (VOID)
BOOL	IsPreVistaOSVersion (VOID)
LPWSTR	GetExecutableVendor (IN LPCWSTR lpszFilename)

Macro Definition Documentation

LoadConditionalResourceString

#define LoadConditionalResourceString	(		hInst,
			bCond,
			uIDifT,
			uIDifF
	)		LoadConditionalResourceStringEx((hInst), (bCond), (uIDifT), (uIDifF), NULL)

Definition at line 51 of file utils.h.

LoadResourceString

#define LoadResourceString	(		hInst,
			uID
	)		LoadResourceStringEx((hInst), (uID), NULL)

Definition at line 48 of file utils.h.

MONITOR_AREA

#define MONITOR_AREA   0x0000

Definition at line 70 of file utils.h.

MONITOR_CENTER

#define MONITOR_CENTER   0x0001

Definition at line 67 of file utils.h.

MONITOR_CLIP

#define MONITOR_CLIP   0x0000

Definition at line 68 of file utils.h.

MONITOR_WORKAREA

#define MONITOR_WORKAREA   0x0002

Definition at line 69 of file utils.h.

Function Documentation

ClipOrCenterRectToMonitor()

VOID ClipOrCenterRectToMonitor	(	LPRECT	prc,
		UINT	flags
	)

Definition at line 173 of file utils.c.

{
    HMONITOR    hMonitor;
    MONITORINFO mi;
    RECT        rc;
    int         w = prc->right  - prc->left;
    int         h = prc->bottom - prc->top;
 
    //
    // Get the nearest monitor to the passed rect.
    //
    hMonitor = MonitorFromRect(prc, MONITOR_DEFAULTTONEAREST);
 
    //
    // Get the work area or entire monitor rect.
    //
    mi.cbSize = sizeof(mi);
    GetMonitorInfo(hMonitor, &mi);
 
    if (flags & MONITOR_WORKAREA)
        rc = mi.rcWork;
    else
        rc = mi.rcMonitor;
 
    //
    // Center or clip the passed rect to the monitor rect.
    //
    if (flags & MONITOR_CENTER)
    {
        prc->left   = rc.left + (rc.right  - rc.left - w) / 2;
        prc->top    = rc.top  + (rc.bottom - rc.top  - h) / 2;
        prc->right  = prc->left + w;
        prc->bottom = prc->top  + h;
    }
    else
    {
        prc->left   = max(rc.left, min(rc.right-w,  prc->left));
        prc->top    = max(rc.top,  min(rc.bottom-h, prc->top));
        prc->right  = prc->left + w;
        prc->bottom = prc->top  + h;
    }
}

Referenced by ClipOrCenterWindowToMonitor().

ClipOrCenterWindowToMonitor()

VOID ClipOrCenterWindowToMonitor	(	HWND	hWnd,
		UINT	flags
	)

Definition at line 216 of file utils.c.

{
    RECT rc;
    GetWindowRect(hWnd, &rc);
    ClipOrCenterRectToMonitor(&rc, flags);
    SetWindowPos(hWnd, NULL, rc.left, rc.top, 0, 0, SWP_NOSIZE | SWP_NOZORDER | SWP_NOACTIVATE);
}

Referenced by CreatePropSheet().

FormatDateTime()

LPWSTR FormatDateTime

(

IN LPSYSTEMTIME

pDateTime

)

Definition at line 41 of file utils.c.

{
    LPWSTR lpszDateTime = NULL;
    int iDateBufSize, iTimeBufSize;
 
    if (pDateTime == NULL) return NULL;
 
    iDateBufSize = GetDateFormatW(LOCALE_USER_DEFAULT,
                                  /* Only for Windows 7 : DATE_AUTOLAYOUT | */ DATE_SHORTDATE,
                                  pDateTime,
                                  NULL,
                                  NULL,
                                  0);
    iTimeBufSize = GetTimeFormatW(LOCALE_USER_DEFAULT,
                                  0,
                                  pDateTime,
                                  NULL,
                                  NULL,
                                  0);
 
    if ( (iDateBufSize > 0) && (iTimeBufSize > 0) )
    {
        lpszDateTime = (LPWSTR)MemAlloc(0, (iDateBufSize + iTimeBufSize) * sizeof(WCHAR));
 
        GetDateFormatW(LOCALE_USER_DEFAULT,
                       /* Only for Windows 7 : DATE_AUTOLAYOUT | */ DATE_SHORTDATE,
                       pDateTime,
                       NULL,
                       lpszDateTime,
                       iDateBufSize);
        if (iDateBufSize > 0) lpszDateTime[iDateBufSize-1] = L' ';
        GetTimeFormatW(LOCALE_USER_DEFAULT,
                       0,
                       pDateTime,
                       NULL,
                       lpszDateTime + iDateBufSize,
                       iTimeBufSize);
    }
 
    return lpszDateTime;
}

Referenced by AddService(), and CRecycleBin::GetDetailsOf().

FreeDateTime()

VOID FreeDateTime

(

IN LPWSTR

lpszDateTime

)

Definition at line 84 of file utils.c.

{
    if (lpszDateTime)
        MemFree(lpszDateTime);
}

Referenced by AddService().

GetExecutableVendor()

LPWSTR GetExecutableVendor

(

IN LPCWSTR

lpszFilename

)

Definition at line 288 of file utils.c.

{
    LPWSTR lpszVendor = NULL;
    DWORD dwHandle = 0;
    DWORD dwLen;
 
    LPVOID lpData;
 
    LPVOID pvData = NULL;
    UINT BufLen = 0;
    WORD wCodePage = 0, wLangID = 0;
    LPWSTR lpszStrFileInfo = NULL;
 
    LPWSTR lpszData = NULL;
 
    if (lpszFilename == NULL) return NULL;
 
    dwLen = GetFileVersionInfoSizeW(lpszFilename, &dwHandle);
    if (dwLen == 0) return NULL;
 
    lpData = MemAlloc(0, dwLen);
    if (!lpData) return NULL;
 
    GetFileVersionInfoW(lpszFilename, dwHandle, dwLen, lpData);
 
    if (VerQueryValueW(lpData, L"\\VarFileInfo\\Translation", &pvData, &BufLen))
    {
        wCodePage = LOWORD(*(DWORD*)pvData);
        wLangID   = HIWORD(*(DWORD*)pvData);
 
        lpszStrFileInfo = FormatString(L"StringFileInfo\\%04X%04X\\CompanyName",
                                       wCodePage,
                                       wLangID);
    }
 
    VerQueryValueW(lpData, lpszStrFileInfo, (LPVOID*)&lpszData, &BufLen);
    if (lpszData)
    {
        lpszVendor = (LPWSTR)MemAlloc(0, BufLen * sizeof(WCHAR));
        if (lpszVendor)
            wcscpy(lpszVendor, lpszData);
    }
    else
    {
        lpszVendor = NULL;
    }
 
    MemFree(lpszStrFileInfo);
    MemFree(lpData);
 
    return lpszVendor;
}

Referenced by AddService().

IsPreVistaOSVersion()

BOOL IsPreVistaOSVersion

(

VOID

)

Definition at line 275 of file utils.c.

{
    OSVERSIONINFOW osvi = {0};
    osvi.dwOSVersionInfoSize = sizeof(osvi);
 
    if (!GetVersionExW(&osvi))
        return FALSE;
 
    /* Vista+-class OSes are NT >= 6 */
    return ( (osvi.dwPlatformId == VER_PLATFORM_WIN32_NT) ? (osvi.dwMajorVersion < 6) : FALSE );
}

Referenced by Initialize().

IsWindowsOS()

BOOL IsWindowsOS

(

VOID

)

Definition at line 226 of file utils.c.

{
    BOOL bIsWindowsOS = FALSE;
 
    OSVERSIONINFOW osvi = {0};
    osvi.dwOSVersionInfoSize = sizeof(osvi);
 
    if (!GetVersionExW(&osvi))
        return FALSE;
 
    if (osvi.dwPlatformId != VER_PLATFORM_WIN32_NT)
        return FALSE;
 
    /* ReactOS reports as Windows NT 5.2 */
 
    if ( (osvi.dwMajorVersion == 5 && osvi.dwMinorVersion >= 2) ||
         (osvi.dwMajorVersion  > 5) )
    {
        HKEY hKey = NULL;
 
        if (RegOpenKeyExW(HKEY_LOCAL_MACHINE,
                          L"SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion",
                          0, KEY_QUERY_VALUE, &hKey) == ERROR_SUCCESS)
        {
            LONG ret;
            DWORD dwType = 0, dwBufSize = 0;
 
            ret = RegQueryValueExW(hKey, L"ProductName", NULL, &dwType, NULL, &dwBufSize);
            if (ret == ERROR_SUCCESS && dwType == REG_SZ)
            {
                LPTSTR lpszProductName = (LPTSTR)MemAlloc(0, dwBufSize);
                RegQueryValueExW(hKey, L"ProductName", NULL, &dwType, (LPBYTE)lpszProductName, &dwBufSize);
 
                bIsWindowsOS = (FindSubStrI(lpszProductName, _T("Windows")) != NULL);
 
                MemFree(lpszProductName);
            }
 
            RegCloseKey(hKey);
        }
    }
    else
    {
        bIsWindowsOS = TRUE;
    }
 
    return bIsWindowsOS;
}

Referenced by Initialize().

LoadConditionalResourceStringEx()

LPWSTR LoadConditionalResourceStringEx	(	IN HINSTANCE	hInstance,
		IN BOOL	bCondition,
		IN UINT	uIDifTrue,
		IN UINT	uIDifFalse,
		IN size_t *pSize	OPTIONAL
	)

Definition at line 120 of file utils.c.

{
    return LoadResourceStringEx(hInstance,
                                (bCondition ? uIDifTrue : uIDifFalse),
                                pSize);
}

LoadResourceStringEx()

LPWSTR LoadResourceStringEx	(	IN HINSTANCE	hInstance,
		IN UINT	uID,
		OUT size_t *pSize	OPTIONAL
	)

Definition at line 91 of file utils.c.

{
    LPWSTR lpszDestBuf = NULL, lpszResourceString = NULL;
    size_t iStrSize    = 0;
 
    // When passing a zero-length buffer size, LoadString(...) returns a
    // read-only pointer buffer to the program's resource string.
    iStrSize = LoadStringW(hInstance, uID, (LPWSTR)&lpszResourceString, 0);
 
    if ( lpszResourceString && ( (lpszDestBuf = (LPWSTR)MemAlloc(0, (iStrSize + 1) * sizeof(WCHAR))) != NULL ) )
    {
        wcsncpy(lpszDestBuf, lpszResourceString, iStrSize);
        lpszDestBuf[iStrSize] = L'\0'; // NULL-terminate the string
 
        if (pSize)
            *pSize = iStrSize + 1;
    }
    else
    {
        if (pSize)
            *pSize = 0;
    }
 
    return lpszDestBuf;
}

Referenced by LoadConditionalResourceStringEx().

MemAlloc()

PVOID MemAlloc	(	IN DWORD	dwFlags,
		IN SIZE_T	dwBytes
	)

Definition at line 33 of file utils.c.

{
    /* Allocate memory from the heap */
    return HeapAlloc(g_hHeap, dwFlags, dwBytes);
}

Referenced by AddDll(), AddService(), AnsiToUnicode(), BackupIniFile(), BuildCommandOptions(), BuildServiceArray(), BuildServiceTable(), DuplicateStringA(), DuplicateStringAEx(), DuplicateStringW(), DuplicateStringWEx(), DwInitializeSdFromThreadToken(), FileExtractDialogWndProc(), FileQueryFiles(), FormatDateTime(), FormatStringV(), GetExecutableVendor(), GetServiceMainFunctions(), GetServices(), IsWindowsOS(), LoadIniFile(), LoadResourceStringEx(), MyFileExists(), RegQueryRegistryValues(), RegQueryStringA(), RegQueryValueWithAlloc(), RequiredServicesDisablingDialogWndProc(), RunCommand(), ServicesPageWndProc(), SvcRegisterStopCallback(), TreeView_SetBOOLCheck(), UnicodeToAnsi(), Update_States(), and WriteIniFile().

MemFree()

BOOL MemFree

(

IN PVOID

lpMem

)

Definition at line 26 of file utils.c.

{
    /* Free memory back into the heap */
    return HeapFree(g_hHeap, 0, lpMem);
}

Referenced by AddItem(), AddService(), BackupIniFile(), BuildCommandOptions(), Cleanup(), DwInitializeSdFromThreadToken(), FileExtractDialogWndProc(), FileQueryFiles(), FreeDateTime(), GetComCtl32Version(), GetExecutableVendor(), GetServiceMainFunctions(), GetServices(), Initialize(), InitializeSecurity(), IsWindowsOS(), LoadIniFile(), LoadXMLDocumentFromFile(), LoadXMLDocumentFromResource(), MyFileExists(), PropSheetCallback(), RegQueryRegistryValues(), RegQueryStringA(), RegQueryValueWithAlloc(), RequiredServicesDisablingDialogWndProc(), RunCommand(), ServicesPageWndProc(), SvchostStopCallback(), SvcRegisterStopCallback(), ToolsPageWndProc(), TreeView_SetBOOLCheck(), Update_States(), wmainCRTStartup(), and WriteIniFile().

RunCommand()

DWORD RunCommand	(	IN LPCWSTR	lpszCommand,
		IN LPCWSTR	lpszParameters,
		IN INT	nShowCmd
	)

Definition at line 132 of file utils.c.

{
    DWORD dwRes;
 
    DWORD dwNumOfChars;
    LPWSTR lpszExpandedCommand;
 
    dwNumOfChars = ExpandEnvironmentStringsW(lpszCommand, NULL, 0);
    lpszExpandedCommand = (LPWSTR)MemAlloc(0, dwNumOfChars * sizeof(WCHAR));
    ExpandEnvironmentStringsW(lpszCommand, lpszExpandedCommand, dwNumOfChars);
 
    dwRes = (DWORD_PTR)ShellExecuteW(NULL,
                                     NULL /* and not L"open" !! */,
                                     lpszExpandedCommand,
                                     lpszParameters,
                                     NULL,
                                     nShowCmd);
    MemFree(lpszExpandedCommand);
 
    return dwRes;
}

Referenced by GeneralPageWndProc(), and TOOL::Run().