utils.h File Reference

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

Go to the source code of this file.

Classes
struct	CMVERBMAP

Macros
#define	OPTIONAL_(arg)
#define	DCIA_Create()   ( (HDCIA)DSA_Create(sizeof(CLSID), 4) )
#define	DCIA_Destroy(hDCIA)   DSA_Destroy((HDSA)(hDCIA))
#define	DCIA_GetCount(hDCIA)   DSA_GetItemCount((HDSA)(hDCIA))
#define	DCIA_GetEntry(hDCIA, iItem)   ( (const CLSID*)DSA_GetItemPtr((HDSA)(hDCIA), (iItem)) )

Typedefs
typedef HDSA	HDCIA

Functions
static BOOL	IsEqualPersistClassID (IPersist *pPersist, REFCLSID clsid)
static BOOL	RegValueExists (HKEY hKey, LPCWSTR Name)
BOOL	RegKeyExists (HKEY hKey, LPCWSTR Path)
UINT	RegQueryDword (HKEY hKey, PCWSTR pszPath, PCWSTR pszName, DWORD *pnVal)
DWORD	RegGetDword (HKEY hKey, PCWSTR pszPath, PCWSTR pszName, DWORD nDefVal)
DWORD	RegSetOrDelete (HKEY hKey, LPCWSTR Name, DWORD Type, LPCVOID Data, DWORD Size)
static DWORD	RegSetString (HKEY hKey, LPCWSTR Name, LPCWSTR Str, DWORD Type OPTIONAL_(REG_SZ))
HRESULT	SHELL_MapContextMenuVerbToCmdId (LPCMINVOKECOMMANDINFO pICI, const CMVERBMAP *pMap)
HRESULT	SHELL_GetCommandStringImpl (SIZE_T CmdId, UINT uFlags, LPSTR Buf, UINT cchBuf, const CMVERBMAP *pMap)
HICON	SHELL32_SHExtractIcon (LPCWSTR File, int Index, int cx, int cy)
HRESULT	SHELL_CreateShell32DefaultExtractIcon (int IconIndex, REFIID riid, LPVOID *ppvOut)
static HRESULT	SHELL_CreateFallbackExtractIconForFolder (REFIID riid, LPVOID *ppvOut)
static HRESULT	SHELL_CreateFallbackExtractIconForNoAssocFile (REFIID riid, LPVOID *ppvOut)
int	DCIA_AddEntry (HDCIA hDCIA, REFCLSID rClsId)
void	DCIA_AddShellExSubkey (HDCIA hDCIA, HKEY hProgId, PCWSTR pszSubkey)

Macro Definition Documentation

DCIA_Create

#define DCIA_Create

(

)

( (HDCIA)DSA_Create(sizeof(CLSID), 4) )

Definition at line 124 of file utils.h.

DCIA_Destroy

#define DCIA_Destroy

(

hDCIA

)

DSA_Destroy((HDSA)(hDCIA))

Definition at line 125 of file utils.h.

DCIA_GetCount

#define DCIA_GetCount

(

hDCIA

)

DSA_GetItemCount((HDSA)(hDCIA))

Definition at line 126 of file utils.h.

DCIA_GetEntry

#define DCIA_GetEntry	(		hDCIA,
			iItem
	)		( (const CLSID*)DSA_GetItemPtr((HDSA)(hDCIA), (iItem)) )

Definition at line 127 of file utils.h.

OPTIONAL_

#define OPTIONAL_

(

arg

)

Definition at line 14 of file utils.h.

Typedef Documentation

HDCIA

typedef HDSA HDCIA

Definition at line 123 of file utils.h.

Function Documentation

DCIA_AddEntry()

int DCIA_AddEntry	(	HDCIA	hDCIA,
		REFCLSID	rClsId
	)

Definition at line 1907 of file utils.cpp.

{
    for (UINT i = 0;; ++i)
    {
        const CLSID *pClsId = DCIA_GetEntry(hDCIA, i);
        if (!pClsId)
            break;
        if (IsEqualGUID(*pClsId, rClsId))
            return i; // Don't allow duplicates
    }
    return DSA_AppendItem((HDSA)hDCIA, const_cast<CLSID*>(&rClsId));
}

Referenced by DCIA_AddShellExSubkey().

DCIA_AddShellExSubkey()

void DCIA_AddShellExSubkey	(	HDCIA	hDCIA,
		HKEY	hProgId,
		PCWSTR	pszSubkey
	)

Definition at line 1920 of file utils.cpp.

{
    WCHAR szKey[200];
    PathCombineW(szKey, L"shellex", pszSubkey);
    HKEY hEnum;
    if (RegOpenKeyExW(hProgId, szKey, 0, KEY_READ, &hEnum) != ERROR_SUCCESS)
        return;
    for (UINT i = 0; RegEnumKeyW(hEnum, i++, szKey, _countof(szKey)) == ERROR_SUCCESS;)
    {
        CLSID clsid;
        if (SUCCEEDED(SHELL_GetShellExtensionRegCLSID(hEnum, szKey, &clsid)))
            DCIA_AddEntry(hDCIA, clsid);
    }
    RegCloseKey(hEnum);
}

Referenced by CFSDropTarget::_GetEffectFromMenu().

IsEqualPersistClassID()

static BOOL IsEqualPersistClassID ( IPersist *  pPersist, REFCLSID  clsid  )

inlinestatic

Definition at line 36 of file utils.h.

{
    CLSID temp;
    return pPersist && SUCCEEDED(pPersist->GetClassID(&temp)) && IsEqualCLSID(clsid, temp);
}

Referenced by CDefView::OnCreate().

RegGetDword()

DWORD RegGetDword ( HKEY  hKey, PCWSTR  pszPath, PCWSTR  pszName, DWORD  nDefVal  )

inline

Definition at line 65 of file utils.h.

{
    DWORD nVal;
    return RegQueryDword(hKey, pszPath, pszName, &nVal) == ERROR_SUCCESS ? nVal : nDefVal;
}

Referenced by CDefaultContextMenu::AddStaticContextMenusToMenu(), and CDefaultContextMenu::BrowserFlagsFromVerb().

RegKeyExists()

BOOL RegKeyExists ( HKEY  hKey, LPCWSTR  Path  )

inline

Definition at line 49 of file utils.h.

{
    BOOL ret = !RegOpenKeyExW(hKey, Path, 0, MAXIMUM_ALLOWED, &hKey);
    if (ret)
        RegCloseKey(hKey);
    return ret;
}

Referenced by DCMA_InsertMenuItems(), EditTypeDlg_ReadClass(), and EditTypeDlg_WriteClass().

RegQueryDword()

UINT RegQueryDword ( HKEY  hKey, PCWSTR  pszPath, PCWSTR  pszName, DWORD *  pnVal  )

inline

Definition at line 58 of file utils.h.

{
    DWORD cb = sizeof(*pnVal);
    return RegGetValueW(hKey, pszPath, pszName, RRF_RT_REG_DWORD, NULL, pnVal, &cb);
}

Referenced by RegGetDword().

RegSetOrDelete()

DWORD RegSetOrDelete ( HKEY  hKey, LPCWSTR  Name, DWORD  Type, LPCVOID  Data, DWORD  Size  )

inline

Definition at line 72 of file utils.h.

{
    if (Data)
        return RegSetValueExW(hKey, Name, 0, Type, (LPBYTE)Data, Size);
    else
        return RegDeleteValueW(hKey, Name);
}

Referenced by EditTypeDlg_WriteClass().

RegSetString()

static DWORD RegSetString ( HKEY  hKey, LPCWSTR  Name, LPCWSTR  Str, DWORD Type   OPTIONAL_REG_SZ  )

inlinestatic

Definition at line 81 of file utils.h.

{
    return RegSetValueExW(hKey, Name, 0, Type, (LPBYTE)Str, (lstrlenW(Str) + 1) * sizeof(WCHAR));
}

Referenced by EditTypeDlg_WriteClass(), FileTypesDlg_AddExt(), and COpenWithList::SetDefaultHandler().

RegValueExists()

static BOOL RegValueExists ( HKEY  hKey, LPCWSTR  Name  )

inlinestatic

Definition at line 43 of file utils.h.

{
    return RegQueryValueExW(hKey, Name, NULL, NULL, NULL, NULL) == ERROR_SUCCESS;
}

Referenced by CDefaultContextMenu::AddStaticContextMenusToMenu(), EditTypeDlg_ReadClass(), and FileTypesDlg_InsertToLV().

SHELL32_SHExtractIcon()

HICON SHELL32_SHExtractIcon ( LPCWSTR  File, int  Index, int  cx, int  cy  )

inline

Definition at line 99 of file utils.h.

{
    HICON hIco;
    int r = PrivateExtractIconsW(File, Index, cx, cy, &hIco, NULL, 1, 0);
    return r > 0 ? hIco : NULL;
}

Referenced by DoExtractIcon().

SHELL_CreateFallbackExtractIconForFolder()

static HRESULT SHELL_CreateFallbackExtractIconForFolder ( REFIID  riid, LPVOID *  ppvOut  )

inlinestatic

Definition at line 110 of file utils.h.

{
    const int id = IDI_SHELL_FOLDER;
    return SHELL_CreateShell32DefaultExtractIcon(id > 1 ? -id : 0, riid, ppvOut);
}

Referenced by CRecyclerExtractIcon_CreateInstance().

SHELL_CreateFallbackExtractIconForNoAssocFile()

static HRESULT SHELL_CreateFallbackExtractIconForNoAssocFile ( REFIID  riid, LPVOID *  ppvOut  )

inlinestatic

Definition at line 117 of file utils.h.

{
    const int id = IDI_SHELL_DOCUMENT;
    return SHELL_CreateShell32DefaultExtractIcon(id > 1 ? -id : 0, riid, ppvOut);
}

Referenced by CRecyclerExtractIcon_CreateInstance().

SHELL_CreateShell32DefaultExtractIcon()

HRESULT SHELL_CreateShell32DefaultExtractIcon	(	int	IconIndex,
		REFIID	riid,
		LPVOID *	ppvOut
	)

Definition at line 1897 of file utils.cpp.

{
    CComPtr<IDefaultExtractIconInit> initIcon;
    HRESULT hr = SHCreateDefaultExtractIcon(IID_PPV_ARG(IDefaultExtractIconInit, &initIcon));
    if (FAILED_UNEXPECTEDLY(hr))
        return hr;
    initIcon->SetNormalIcon(swShell32Name, IconIndex);
    return initIcon->QueryInterface(riid, ppvOut);
}

Referenced by SHELL_CreateFallbackExtractIconForFolder(), and SHELL_CreateFallbackExtractIconForNoAssocFile().

SHELL_GetCommandStringImpl()

HRESULT SHELL_GetCommandStringImpl	(	SIZE_T	CmdId,
		UINT	uFlags,
		LPSTR	Buf,
		UINT	cchBuf,
		const CMVERBMAP *	pMap
	)

Definition at line 1874 of file utils.cpp.

{
    const CMVERBMAP* pEntry;
    switch (uFlags | GCS_UNICODE)
    {
        case GCS_VALIDATEW:
        case GCS_VERBW:
            pEntry = FindVerbMapEntry(CmdId, pMap);
            if ((uFlags | GCS_UNICODE) == GCS_VERBW)
            {
                if (!pEntry)
                    return E_INVALIDARG;
                else if (uFlags & GCS_UNICODE)
                    return SHAnsiToUnicode(pEntry->Verb, (LPWSTR)Buf, cchBuf) ? S_OK : E_FAIL;
                else
                    return StringCchCopyA(Buf, cchBuf, pEntry->Verb);
            }
            return pEntry ? S_OK : S_FALSE; // GCS_VALIDATE
    }
    return E_NOTIMPL;
}

Referenced by CCopyAsPathMenu::GetCommandString(), COpenWithMenu::GetCommandString(), CRecycleBinItemContextMenu::GetCommandString(), and CRecycleBin::GetCommandString().

SHELL_MapContextMenuVerbToCmdId()

HRESULT SHELL_MapContextMenuVerbToCmdId	(	LPCMINVOKECOMMANDINFO	pICI,
		const CMVERBMAP *	pMap
	)

Definition at line 1840 of file utils.cpp.

{
    LPCSTR pVerbA = pICI->lpVerb;
    CHAR buf[MAX_PATH];
    LPCMINVOKECOMMANDINFOEX pICIX = (LPCMINVOKECOMMANDINFOEX)pICI;
    if (IsUnicode(*pICIX) && !IS_INTRESOURCE(pICIX->lpVerbW))
    {
        if (SHUnicodeToAnsi(pICIX->lpVerbW, buf, _countof(buf)))
            pVerbA = buf;
    }
 
    if (IS_INTRESOURCE(pVerbA))
        return LOWORD(pVerbA);
    for (SIZE_T i = 0; pMap[i].Verb; ++i)
    {
        assert(SUCCEEDED((int)(pMap[i].CmdId))); // The id must be >= 0 and ideally in the 0..0x7fff range
        if (!lstrcmpiA(pMap[i].Verb, pVerbA) && pVerbA[0])
            return pMap[i].CmdId;
    }
    return E_FAIL;
}

Referenced by CCopyAsPathMenu::InvokeCommand(), COpenWithMenu::InvokeCommand(), CRecycleBinItemContextMenu::InvokeCommand(), and CRecycleBin::InvokeCommand().