CInstalledApplicationInfo Class Reference

#include <installed.h>

Collaboration diagram for CInstalledApplicationInfo:

Public Member Functions
	CInstalledApplicationInfo (BOOL bIsUserKey, REGSAM RegWowKey, HKEY hKey)
BOOL	GetApplicationRegString (LPCWSTR lpKeyName, ATL::CStringW &String)
BOOL	GetApplicationRegDword (LPCWSTR lpKeyName, DWORD *lpValue)
BOOL	RetrieveIcon (ATL::CStringW &IconLocation)
BOOL	UninstallApplication (BOOL bModify)
LSTATUS	RemoveFromRegistry ()
	~CInstalledApplicationInfo ()

Public Attributes
BOOL	IsUserKey
REGSAM	WowKey
HKEY	hSubKey
BOOL	bIsUpdate = FALSE
ATL::CStringW	szKeyName
ATL::CStringW	szDisplayIcon
ATL::CStringW	szDisplayName
ATL::CStringW	szDisplayVersion
ATL::CStringW	szPublisher
ATL::CStringW	szRegOwner
ATL::CStringW	szProductID
ATL::CStringW	szHelpLink
ATL::CStringW	szHelpTelephone
ATL::CStringW	szReadme
ATL::CStringW	szContact
ATL::CStringW	szURLUpdateInfo
ATL::CStringW	szURLInfoAbout
ATL::CStringW	szComments
ATL::CStringW	szInstallDate
ATL::CStringW	szInstallLocation
ATL::CStringW	szInstallSource
ATL::CStringW	szUninstallString
ATL::CStringW	szModifyPath

Detailed Description

Definition at line 6 of file installed.h.

Constructor & Destructor Documentation

CInstalledApplicationInfo()

CInstalledApplicationInfo::CInstalledApplicationInfo	(	BOOL	bIsUserKey,
		REGSAM	RegWowKey,
		HKEY	hKey
	)

Definition at line 15 of file installed.cpp.

    : IsUserKey(bIsUserKey), WowKey(RegWowKey), hSubKey(hKey)
{
    // if Initialize failed, hSubKey will be closed automatically and set to zero

    DWORD dwSize = MAX_PATH, dwType, dwValue;
    BOOL bIsSystemComponent;
    ATL::CStringW szParentKeyName;

    dwType = REG_DWORD;
    dwSize = sizeof(DWORD);

    if (RegQueryValueExW(hSubKey,
        L"SystemComponent",
        NULL,
        &dwType,
        (LPBYTE)&dwValue,
        &dwSize) == ERROR_SUCCESS)
    {
        bIsSystemComponent = (dwValue == 0x1);
    }
    else
    {
        bIsSystemComponent = FALSE;
    }

    dwType = REG_SZ;
    dwSize = MAX_PATH * sizeof(WCHAR);
    bIsUpdate = (RegQueryValueExW(hSubKey,
        L"ParentKeyName",
        NULL,
        &dwType,
        (LPBYTE)szParentKeyName.GetBuffer(MAX_PATH),
        &dwSize) == ERROR_SUCCESS);
    szParentKeyName.ReleaseBuffer();

    if (bIsSystemComponent)
    {
        CloseHandle(hSubKey);
        hSubKey = NULL;
    }

}

~CInstalledApplicationInfo()

CInstalledApplicationInfo::~CInstalledApplicationInfo

(

)

Definition at line 59 of file installed.cpp.

{
    if (hSubKey)
    {
        CloseHandle(hSubKey);
        hSubKey = NULL;
    }
}

Member Function Documentation

GetApplicationRegDword()

BOOL CInstalledApplicationInfo::GetApplicationRegDword	(	LPCWSTR	lpKeyName,
		DWORD *	lpValue
	)

Definition at line 112 of file installed.cpp.

{
    DWORD dwType = REG_DWORD;
    DWORD dwSize = sizeof(DWORD);
    if (RegQueryValueExW(hSubKey,
        lpKeyName,
        NULL,
        &dwType,
        (LPBYTE)lpValue,
        &dwSize) != ERROR_SUCCESS)
    {
        return FALSE;
    }

    return TRUE;
}

GetApplicationRegString()

BOOL CInstalledApplicationInfo::GetApplicationRegString	(	LPCWSTR	lpKeyName,
		ATL::CStringW &	String
	)

Definition at line 68 of file installed.cpp.

{
    DWORD dwSize = 0;
    String.Empty();
    DWORD dwType;

    // retrieve the size of value first.
    if (RegQueryValueExW(hSubKey,
        lpKeyName,
        NULL,
        &dwType,
        NULL,
        &dwSize) != ERROR_SUCCESS)
    {
        return FALSE;
    }

    // TODO: I assume the type as REG_SZ. but I think REG_EXPAND_SZ should be handled correctly too.
    if (dwType != REG_SZ)
    {
        return FALSE;
    }

    // allocate buffer.
    // attention: dwSize is size in bytes, and RegQueryValueExW does not guarantee the terminating null character.
    String.GetBuffer(dwSize + sizeof(WCHAR));

    // query the value
    if (RegQueryValueExW(hSubKey,
        lpKeyName,
        NULL,
        NULL,
        (LPBYTE)String.GetBuffer(),
        &dwSize) != ERROR_SUCCESS)
    {
        String.ReleaseBuffer();
        String.Empty();
        return FALSE;
    }
    String.GetBuffer()[dwSize / sizeof(WCHAR)] = L'\0'; // ensure zero terminated
    String.ReleaseBuffer();
    return TRUE;
}

RemoveFromRegistry()

LSTATUS CInstalledApplicationInfo::RemoveFromRegistry

(

)

Definition at line 146 of file installed.cpp.

{
    ATL::CStringW szFullName = L"Software\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\" + szKeyName;
    HMODULE hMod = GetModuleHandleW(L"advapi32.dll");
    RegDeleteKeyExWProc pRegDeleteKeyExW;

    // TODO: if there are subkeys inside, simply RegDeleteKeyExW
    // (or RegDeleteKeyW on Server 2003 SP0 and earlier) will fail
    // we don't have RegDeleteTree for ReactOS now. (It's a WinVista API)
    // write a function to delete all subkeys recursively to solve this
    // or consider letting ReactOS having this API

    /* Load RegDeleteKeyExW from advapi32.dll if available */
    if (hMod)
    {
        pRegDeleteKeyExW = (RegDeleteKeyExWProc)GetProcAddress(hMod, "RegDeleteKeyExW");

        if (pRegDeleteKeyExW)
        {
            /* Return it */
            return pRegDeleteKeyExW(IsUserKey ? HKEY_CURRENT_USER : HKEY_LOCAL_MACHINE, szFullName, WowKey, 0);
        }
    }

    /* Otherwise, return non-Ex function */
    return RegDeleteKeyW(IsUserKey ? HKEY_CURRENT_USER : HKEY_LOCAL_MACHINE, szFullName);
}

Referenced by CMainWindow::RemoveSelectedAppFromRegistry().

RetrieveIcon()

BOOL CInstalledApplicationInfo::RetrieveIcon

(

ATL::CStringW &

IconLocation

)

Definition at line 129 of file installed.cpp.

{
    if (szDisplayIcon.IsEmpty())
    {
        return FALSE;
    }
    IconLocation = szDisplayIcon;
    return TRUE;
}

Referenced by CAppsListView::AddInstalledApplication().

UninstallApplication()

BOOL CInstalledApplicationInfo::UninstallApplication

(

BOOL

bModify

)

Definition at line 139 of file installed.cpp.

{
    return StartProcess(bModify ? szModifyPath : szUninstallString, TRUE);
}

Referenced by CMainWindow::UninstallSelectedApp().

Member Data Documentation

bIsUpdate

BOOL CInstalledApplicationInfo::bIsUpdate = FALSE

Definition at line 12 of file installed.h.

Referenced by CInstalledApplicationInfo().

hSubKey

HKEY CInstalledApplicationInfo::hSubKey

Definition at line 11 of file installed.h.

Referenced by CInstalledApplicationInfo(), GetApplicationRegDword(), GetApplicationRegString(), and ~CInstalledApplicationInfo().

IsUserKey

BOOL CInstalledApplicationInfo::IsUserKey

Definition at line 9 of file installed.h.

Referenced by RemoveFromRegistry().

szComments

ATL::CStringW CInstalledApplicationInfo::szComments

Definition at line 35 of file installed.h.

Referenced by CAppsListView::AddInstalledApplication().

szContact

ATL::CStringW CInstalledApplicationInfo::szContact

Definition at line 32 of file installed.h.

szDisplayIcon

ATL::CStringW CInstalledApplicationInfo::szDisplayIcon

Definition at line 23 of file installed.h.

Referenced by RetrieveIcon().

szDisplayName

ATL::CStringW CInstalledApplicationInfo::szDisplayName

Definition at line 24 of file installed.h.

Referenced by CAppsListView::AddInstalledApplication().

szDisplayVersion

ATL::CStringW CInstalledApplicationInfo::szDisplayVersion

Definition at line 25 of file installed.h.

Referenced by CAppsListView::AddInstalledApplication().

szHelpLink

ATL::CStringW CInstalledApplicationInfo::szHelpLink

Definition at line 29 of file installed.h.

szHelpTelephone

ATL::CStringW CInstalledApplicationInfo::szHelpTelephone

Definition at line 30 of file installed.h.

szInstallDate

ATL::CStringW CInstalledApplicationInfo::szInstallDate

Definition at line 36 of file installed.h.

szInstallLocation

ATL::CStringW CInstalledApplicationInfo::szInstallLocation

Definition at line 37 of file installed.h.

szInstallSource

ATL::CStringW CInstalledApplicationInfo::szInstallSource

Definition at line 38 of file installed.h.

szKeyName

ATL::CStringW CInstalledApplicationInfo::szKeyName

Definition at line 14 of file installed.h.

Referenced by RemoveFromRegistry().

szModifyPath

ATL::CStringW CInstalledApplicationInfo::szModifyPath

Definition at line 40 of file installed.h.

Referenced by UninstallApplication().

szProductID

ATL::CStringW CInstalledApplicationInfo::szProductID

Definition at line 28 of file installed.h.

szPublisher

ATL::CStringW CInstalledApplicationInfo::szPublisher

Definition at line 26 of file installed.h.

szReadme

ATL::CStringW CInstalledApplicationInfo::szReadme

Definition at line 31 of file installed.h.

szRegOwner

ATL::CStringW CInstalledApplicationInfo::szRegOwner

Definition at line 27 of file installed.h.

szUninstallString

ATL::CStringW CInstalledApplicationInfo::szUninstallString

Definition at line 39 of file installed.h.

Referenced by UninstallApplication().

szURLInfoAbout

ATL::CStringW CInstalledApplicationInfo::szURLInfoAbout

Definition at line 34 of file installed.h.

szURLUpdateInfo

ATL::CStringW CInstalledApplicationInfo::szURLUpdateInfo

Definition at line 33 of file installed.h.

WowKey

REGSAM CInstalledApplicationInfo::WowKey

Definition at line 10 of file installed.h.

Referenced by RemoveFromRegistry().

---

The documentation for this class was generated from the following files:

• base/applications/rapps/include/installed.h
• base/applications/rapps/installed.cpp