CCommonFolder< TSelf, TItemId, TExtractIcon > Class Template Reference

#include <foldercommon.h>

Inheritance diagram for CCommonFolder< TSelf, TItemId, TExtractIcon >:

Collaboration diagram for CCommonFolder< TSelf, TItemId, TExtractIcon >:

Public Member Functions
	CCommonFolder ()
virtual	~CCommonFolder ()
STDMETHODIMP	ParseDisplayName (HWND hwndOwner, LPBC pbcReserved, LPOLESTR lpszDisplayName, ULONG *pchEaten, LPITEMIDLIST *ppidl, ULONG *pdwAttributes) override
STDMETHOD()	EnumObjects (HWND hwndOwner, SHCONTF grfFlags, IEnumIDList **ppenumIDList) PURE
STDMETHODIMP	BindToObject (LPCITEMIDLIST pidl, LPBC pbcReserved, REFIID riid, void **ppvOut) override
STDMETHODIMP	BindToStorage (LPCITEMIDLIST pidl, LPBC pbcReserved, REFIID riid, void **ppvObj) override
STDMETHODIMP	CompareIDs (LPARAM lParam, LPCITEMIDLIST pidl1, LPCITEMIDLIST pidl2) override
STDMETHODIMP	CreateViewObject (HWND hwndOwner, REFIID riid, void **ppvOut) override
STDMETHODIMP	GetAttributesOf (UINT cidl, PCUITEMID_CHILD_ARRAY apidl, SFGAOF *rgfInOut) override
STDMETHODIMP	GetUIObjectOf (HWND hwndOwner, UINT cidl, PCUITEMID_CHILD_ARRAY apidl, REFIID riid, UINT *prgfInOut, void **ppvOut) override
STDMETHODIMP	GetDisplayNameOf (LPCITEMIDLIST pidl, SHGDNF uFlags, STRRET *lpName) override
STDMETHODIMP	SetNameOf (HWND hwnd, LPCITEMIDLIST pidl, LPCOLESTR lpszName, SHGDNF uFlags, LPITEMIDLIST *ppidlOut) override
STDMETHODIMP	GetDefaultSearchGUID (GUID *lpguid) override
STDMETHODIMP	EnumSearches (IEnumExtraSearch **ppenum) override
STDMETHODIMP	GetDefaultColumn (DWORD dwReserved, ULONG *pSort, ULONG *pDisplay) override
STDMETHOD()	GetDefaultColumnState (UINT iColumn, SHCOLSTATEF *pcsFlags) PURE
STDMETHOD()	GetDetailsEx (LPCITEMIDLIST pidl, const SHCOLUMNID *pscid, VARIANT *pv) PURE
STDMETHOD()	GetDetailsOf (LPCITEMIDLIST pidl, UINT iColumn, SHELLDETAILS *psd) PURE
STDMETHOD()	MapColumnToSCID (UINT iColumn, SHCOLUMNID *pscid) PURE
STDMETHODIMP	GetClassID (CLSID *lpClassId) override
STDMETHODIMP	Initialize (PCIDLIST_ABSOLUTE pidl) override
STDMETHODIMP	GetCurFolder (PIDLIST_ABSOLUTE *pidl) override
Public Member Functions inherited from ATL::CComObjectRootEx< CComMultiThreadModelNoCS >
	~CComObjectRootEx ()
ULONG	InternalAddRef ()
ULONG	InternalRelease ()
void	Lock ()
void	Unlock ()
HRESULT	_AtlInitialConstruct ()
Public Member Functions inherited from ATL::CComObjectRootBase
	CComObjectRootBase ()
	~CComObjectRootBase ()
void	SetVoid (void *)
HRESULT	_AtlFinalConstruct ()
HRESULT	FinalConstruct ()
void	InternalFinalConstructAddRef ()
void	InternalFinalConstructRelease ()
void	FinalRelease ()
Public Member Functions inherited from IShellFolder2
HRESULT	GetDefaultSearchGUID ([out] GUID *lpguid)
HRESULT	EnumSearches ([out] IEnumExtraSearch **ppenum)
HRESULT	GetDefaultColumn ([in] DWORD dwReserved, [out] ULONG *pSort, [out] ULONG *pDisplay)
HRESULT	GetDefaultColumnState ([in] UINT iColumn, [out] SHCOLSTATEF *pcsFlags)
HRESULT	GetDetailsEx ([in] PCUITEMID_CHILD pidl, [in] const SHCOLUMNID *pscid, [out] VARIANT *pv)
HRESULT	GetDetailsOf ([in] PCUITEMID_CHILD pidl, [in] UINT iColumn, [out] SHELLDETAILS *psd)
HRESULT	MapColumnToSCID ([in] UINT iColumn, [in] SHCOLUMNID *pscid)
Public Member Functions inherited from IShellFolder
HRESULT	ParseDisplayName ([in] HWND hwndOwner, [in] LPBC pbcReserved, [in, string] LPOLESTR lpszDisplayName, [out] ULONG *pchEaten, [out] PIDLIST_RELATIVE *ppidl, [in, out, unique] ULONG *pdwAttributes)
HRESULT	EnumObjects ([in] HWND hwndOwner, [in] SHCONTF grfFlags, [out] IEnumIDList **ppenumIDList)
HRESULT	BindToObject ([in] PCUIDLIST_RELATIVE pidl, [in] LPBC pbcReserved, [in] REFIID riid, [out, iid_is(riid)] void **ppvOut)
HRESULT	BindToStorage ([in] PCUIDLIST_RELATIVE pidl, [in] LPBC pbcReserved, [in] REFIID riid, [out, iid_is(riid)] void **ppvObj)
HRESULT	CompareIDs ([in] LPARAM lParam, [in] PCUIDLIST_RELATIVE pidl1, [in] PCUIDLIST_RELATIVE pidl2)
HRESULT	CreateViewObject ([in] HWND hwndOwner, [in] REFIID riid, [out, iid_is(riid)] void **ppvOut)
HRESULT	GetAttributesOf ([in] UINT cidl, [in, size_is(cidl)] PCUITEMID_CHILD_ARRAY apidl, [in, out] SFGAOF *rgfInOut)
HRESULT	GetUIObjectOf ([in] HWND hwndOwner, [in] UINT cidl, [in, size_is(cidl)] PCUITEMID_CHILD_ARRAY apidl, [in] REFIID riid, [in, out, unique] UINT *prgfInOut, [out, iid_is(riid)] void **ppvOut)
HRESULT	GetDisplayNameOf ([in] PCUITEMID_CHILD pidl, [in] SHGDNF uFlags, [out] STRRET *lpName)
HRESULT	SetNameOf ([in] HWND hwnd, [in] PCUITEMID_CHILD pidl, [in, string] LPCOLESTR lpszName, [in] SHGDNF uFlags, [out] PITEMID_CHILD *ppidlOut)
Public Member Functions inherited from IUnknown
HRESULT	QueryInterface ([in] REFIID riid, [out, iid_is(riid)] void **ppvObject)
ULONG	AddRef ()
ULONG	Release ()
HRESULT	GetCurFolder ([out] PIDLIST_ABSOLUTE *ppidl)
HRESULT	Initialize ([in] PCIDLIST_ABSOLUTE pidl)
HRESULT	GetClassID ([out] CLSID *pClassID)

Static Public Member Functions
static HRESULT CALLBACK	DefCtxMenuCallback (IShellFolder *, HWND, IDataObject *, UINT uMsg, WPARAM, LPARAM)
Static Public Member Functions inherited from ATL::CComObjectRootBase
static void WINAPI	ObjectMain (bool)
static const struct _ATL_CATMAP_ENTRY *	GetCategoryMap ()
static HRESULT WINAPI	InternalQueryInterface (void *pThis, const _ATL_INTMAP_ENTRY *pEntries, REFIID iid, void **ppvObject)

Protected Member Functions
STDMETHOD()	InternalBindToObject (PWSTR path, const TItemId *info, LPITEMIDLIST first, LPCITEMIDLIST rest, LPITEMIDLIST fullPidl, LPBC pbcReserved, IShellFolder **ppsfChild) PURE
STDMETHOD()	ResolveSymLink (const TItemId *info, LPITEMIDLIST *fullPidl)
STDMETHOD()	CompareName (LPARAM lParam, const TItemId *first, const TItemId *second)
STDMETHOD()	CompareIDs (LPARAM lParam, const TItemId *first, const TItemId *second) PURE
	STDMETHOD_ (ULONG, ConvertAttributes)(const TItemId *entry
	STDMETHOD_ (BOOL, IsFolder)(LPCITEMIDLIST pcidl)
	STDMETHOD_ (BOOL, IsFolder)(const TItemId *info) PURE
	STDMETHOD_ (BOOL, IsSymLink)(LPCITEMIDLIST pcidl)
	STDMETHOD_ (BOOL, IsSymLink)(const TItemId *info)
virtual HRESULT	GetInfoFromPidl (LPCITEMIDLIST pcidl, const TItemId **pentry) PURE

Protected Attributes
WCHAR	m_NtPath [MAX_PATH]
LPITEMIDLIST	m_shellPidl
PULONG inMask	PURE

Additional Inherited Members
Public Types inherited from IShellFolder2
typedef struct IShellFolder2::SHCOLUMNID *	LPSHCOLUMNID
typedef const SHCOLUMNID *	LPCSHCOLUMNID
Public Types inherited from IShellFolder
enum	tagSHGDN {   SHGDN_NORMAL = 0 , SHGDN_INFOLDER = 1 , SHGDN_FOREDITING = 0x1000 , SHGDN_INCLUDE_NONFILESYS = 0x2000 ,   SHGDN_FORADDRESSBAR = 0x4000 , SHGDN_FORPARSING = 0x8000 }
enum	tagSHCONTF {   SHCONTF_FOLDERS = 32 , SHCONTF_NONFOLDERS = 64 , SHCONTF_INCLUDEHIDDEN = 128 , SHCONTF_INIT_ON_FIRST_NEXT = 256 ,   SHCONTF_NETPRINTERSRCH = 512 , SHCONTF_SHAREABLE = 1024 , SHCONTF_STORAGE = 2048 , SHCONTF_NAVIGATION_ENUM = 0x01000 ,   SHCONTF_FASTITEMS = 0x02000 , SHCONTF_FLATLIST = 0x04000 , SHCONTF_ENABLE_ASYNC = 0x08000 , SHCONTF_INCLUDESUPERHIDDEN = 0x10000 }
typedef IShellFolder *	LPSHELLFOLDER
typedef enum IShellFolder::tagSHGDN	SHGNO
typedef DWORD	SHGDNF
typedef DWORD	SHCONTF
typedef ULONG	SFGAOF
Public Types inherited from IUnknown
typedef IUnknown *	LPUNKNOWN
Public Types inherited from IPersistFolder2
typedef IPersistFolder2 *	LPPERSISTFOLDER2
Public Types inherited from IPersistFolder
typedef IPersistFolder *	LPPERSISTFOLDER
Public Types inherited from IPersist
typedef IPersist *	LPPERSIST
Public Attributes inherited from ATL::CComObjectRootBase
LONG	m_dwRef

Detailed Description

template<class TSelf, typename TItemId, class TExtractIcon>
class CCommonFolder< TSelf, TItemId, TExtractIcon >

Definition at line 60 of file foldercommon.h.

Constructor & Destructor Documentation

CCommonFolder()

template<class TSelf , typename TItemId , class TExtractIcon >

CCommonFolder< TSelf, TItemId, TExtractIcon >::CCommonFolder ( )

inline

Definition at line 72 of file foldercommon.h.

                    :
        m_shellPidl(NULL)
    {
    }

~CCommonFolder()

template<class TSelf , typename TItemId , class TExtractIcon >

virtual CCommonFolder< TSelf, TItemId, TExtractIcon >::~CCommonFolder ( )

inlinevirtual

Definition at line 77 of file foldercommon.h.

    {
        if (m_shellPidl)
            ILFree(m_shellPidl);
    }

Member Function Documentation

BindToObject()

template<class TSelf , typename TItemId , class TExtractIcon >

STDMETHODIMP CCommonFolder< TSelf, TItemId, TExtractIcon >::BindToObject ( LPCITEMIDLIST  pidl, LPBC  pbcReserved, REFIID  riid, void **  ppvOut  )

inlineoverride

Definition at line 168 of file foldercommon.h.

    {
        const TItemId * info;
 
        if (IsEqualIID(riid, IID_IShellFolder))
        {
            HRESULT hr = GetInfoFromPidl(pidl, &info);
            if (FAILED_UNEXPECTEDLY(hr))
                return hr;
 
            WCHAR path[MAX_PATH];
 
            StringCbCopyW(path, sizeof(path), m_NtPath);
            PathAppendW(path, info->entryName);
 
            LPITEMIDLIST first = ILCloneFirst(pidl);
            LPCITEMIDLIST rest = ILGetNext(pidl);
 
            LPITEMIDLIST fullPidl = ILCombine(m_shellPidl, first);
 
            CComPtr<IShellFolder> psfChild;
            hr = InternalBindToObject(path, info, first, rest, fullPidl, pbcReserved, &psfChild);
 
            ILFree(fullPidl);
            ILFree(first);
 
            if (FAILED(hr))
                return hr;
 
            if (hr == S_FALSE)
                return S_OK;
 
            if (rest->mkid.cb > 0)
            {
                return psfChild->BindToObject(rest, pbcReserved, riid, ppvOut);
            }
 
            return psfChild->QueryInterface(riid, ppvOut);
        }
 
        return E_NOTIMPL;
    }

BindToStorage()

template<class TSelf , typename TItemId , class TExtractIcon >

STDMETHODIMP CCommonFolder< TSelf, TItemId, TExtractIcon >::BindToStorage ( LPCITEMIDLIST  pidl, LPBC  pbcReserved, REFIID  riid, void **  ppvObj  )

inlineoverride

Definition at line 233 of file foldercommon.h.

    {
        UNIMPLEMENTED;
        return E_NOTIMPL;
    }

CompareIDs() [1/2]

template<class TSelf , typename TItemId , class TExtractIcon >

STDMETHOD() CCommonFolder< TSelf, TItemId, TExtractIcon >::CompareIDs ( LPARAM  lParam, const TItemId *  first, const TItemId *  second  )

protected

CompareIDs() [2/2]

template<class TSelf , typename TItemId , class TExtractIcon >

STDMETHODIMP CCommonFolder< TSelf, TItemId, TExtractIcon >::CompareIDs ( LPARAM  lParam, LPCITEMIDLIST  pidl1, LPCITEMIDLIST  pidl2  )

inlineoverride

Definition at line 243 of file foldercommon.h.

    {
        HRESULT hr;
 
        TRACE("CompareIDs %d\n", lParam);
 
        const TItemId * id1;
        hr = GetInfoFromPidl(pidl1, &id1);
        if (FAILED(hr))
            return E_INVALIDARG;
 
        const TItemId * id2;
        hr = GetInfoFromPidl(pidl2, &id2);
        if (FAILED(hr))
            return E_INVALIDARG;
 
        hr = CompareIDs(lParam, id1, id2);
        if (hr != S_EQUAL)
            return hr;
 
        // The wollowing snipped is basically SHELL32_CompareChildren
 
        PUIDLIST_RELATIVE rest1 = ILGetNext(pidl1);
        PUIDLIST_RELATIVE rest2 = ILGetNext(pidl2);
 
        bool isEmpty1 = (rest1->mkid.cb == 0);
        bool isEmpty2 = (rest2->mkid.cb == 0);
 
        if (isEmpty1 || isEmpty2)
            return MAKE_COMPARE_HRESULT(isEmpty2 - isEmpty1);
 
        LPCITEMIDLIST first1 = ILCloneFirst(pidl1);
        if (!first1)
            return E_OUTOFMEMORY;
 
        CComPtr<IShellFolder> psfNext;
        hr = BindToObject(first1, NULL, IID_PPV_ARG(IShellFolder, &psfNext));
        if (FAILED_UNEXPECTEDLY(hr))
            return hr;
 
        return psfNext->CompareIDs(lParam, rest1, rest2);
    }

CompareName()

template<class TSelf , typename TItemId , class TExtractIcon >

STDMETHOD() CCommonFolder< TSelf, TItemId, TExtractIcon >::CompareName ( LPARAM  lParam, const TItemId *  first, const TItemId *  second  )

inlineprotected

Definition at line 290 of file foldercommon.h.

    {
        bool f1 = IsFolder(first);
        bool f2 = IsFolder(second);
 
        HRESULT hr = MAKE_COMPARE_HRESULT(f2 - f1);
        if (hr != S_EQUAL)
            return hr;
 
        bool canonical = (lParam & 0xFFFF0000) == SHCIDS_CANONICALONLY;
        if (canonical)
        {
            // Shortcut: avoid comparing contents if not necessary when the results are not for display.
            hr = MAKE_COMPARE_HRESULT(second->entryNameLength - first->entryNameLength);
            if (hr != S_EQUAL)
                return hr;
 
            int minlength = min(first->entryNameLength, second->entryNameLength);
            if (minlength > 0)
            {
                hr = MAKE_COMPARE_HRESULT(memcmp(first->entryName, second->entryName, minlength));
                if (hr != S_EQUAL)
                    return hr;
            }
 
            return S_EQUAL;
        }
 
        int minlength = min(first->entryNameLength, second->entryNameLength);
        if (minlength > 0)
        {
            hr = MAKE_COMPARE_HRESULT(StrCmpNW(first->entryName, second->entryName, minlength / sizeof(WCHAR)));
            if (hr != S_EQUAL)
                return hr;
        }
 
        return MAKE_COMPARE_HRESULT(second->entryNameLength - first->entryNameLength);
    }

CreateViewObject()

template<class TSelf , typename TItemId , class TExtractIcon >

STDMETHODIMP CCommonFolder< TSelf, TItemId, TExtractIcon >::CreateViewObject ( HWND  hwndOwner, REFIID  riid, void **  ppvOut  )

inlineoverride

Implements IShellFolder.

Definition at line 333 of file foldercommon.h.

    {
        if (!IsEqualIID(riid, IID_IShellView))
            return E_NOINTERFACE;
 
        _CComObject<CFolderViewCB> *pcb;
 
        HRESULT hr = _CComObject<CFolderViewCB>::CreateInstance(&pcb);
        if (FAILED(hr))
            return hr;
 
        pcb->AddRef();
 
        SFV_CREATE sfv;
        sfv.cbSize = sizeof(sfv);
        sfv.pshf = this;
        sfv.psvOuter = NULL;
        sfv.psfvcb = pcb;
 
        IShellView* view;
 
        hr = SHCreateShellFolderView(&sfv, &view);
        if (FAILED(hr))
            return hr;
 
        pcb->Initialize(view);
 
        pcb->Release();
 
        *ppvOut = view;
 
        return S_OK;
    }

DefCtxMenuCallback()

template<class TSelf , typename TItemId , class TExtractIcon >

static HRESULT CALLBACK CCommonFolder< TSelf, TItemId, TExtractIcon >::DefCtxMenuCallback ( IShellFolder *  , HWND  , IDataObject *  , UINT  uMsg, WPARAM  , LPARAM    )

inlinestatic

Definition at line 694 of file foldercommon.h.

    {
        switch (uMsg)
        {
            case DFM_MERGECONTEXTMENU:
                return S_OK;
 
            case DFM_INVOKECOMMAND:
            case DFM_INVOKECOMMANDEX:
            case DFM_GETDEFSTATICID: // Required for Windows 7 to pick a default
                return S_FALSE;
        }
        return E_NOTIMPL;
    }

EnumObjects()

template<class TSelf , typename TItemId , class TExtractIcon >

STDMETHOD() CCommonFolder< TSelf, TItemId, TExtractIcon >::EnumObjects	(	HWND	hwndOwner,
		SHCONTF	grfFlags,
		IEnumIDList **	ppenumIDList
	)

Implements IShellFolder.

EnumSearches()

template<class TSelf , typename TItemId , class TExtractIcon >

STDMETHODIMP CCommonFolder< TSelf, TItemId, TExtractIcon >::EnumSearches ( IEnumExtraSearch **  ppenum )

inlineoverride

Implements IShellFolder2.

Definition at line 585 of file foldercommon.h.

    {
        UNIMPLEMENTED;
        return E_NOTIMPL;
    }

GetAttributesOf()

template<class TSelf , typename TItemId , class TExtractIcon >

STDMETHODIMP CCommonFolder< TSelf, TItemId, TExtractIcon >::GetAttributesOf ( UINT  cidl, PCUITEMID_CHILD_ARRAY  apidl, SFGAOF *  rgfInOut  )

inlineoverride

Implements IShellFolder.

Definition at line 370 of file foldercommon.h.

    {
        const TItemId * info;
 
        TRACE("GetAttributesOf %d\n", cidl);
 
        if (cidl == 0)
        {
            *rgfInOut &= SFGAO_FOLDER | SFGAO_HASSUBFOLDER | SFGAO_BROWSABLE;
            return S_OK;
        }
 
        for (int i = 0; i < (int)cidl; i++)
        {
            PCUITEMID_CHILD pidl = apidl[i];
 
            HRESULT hr = GetInfoFromPidl(pidl, &info);
            if (FAILED_UNEXPECTEDLY(hr))
                return hr;
 
            // Update attributes.
            *rgfInOut = ConvertAttributes(info, rgfInOut);
        }
 
        return S_OK;
    }

GetClassID()

template<class TSelf , typename TItemId , class TExtractIcon >

STDMETHODIMP CCommonFolder< TSelf, TItemId, TExtractIcon >::GetClassID ( CLSID *  lpClassId )

inlineoverride

Implements IPersist.

Definition at line 622 of file foldercommon.h.

    {
        if (!lpClassId)
            return E_POINTER;
 
        *lpClassId = CLSID_NtObjectFolder;
        return S_OK;
    }

GetCurFolder()

template<class TSelf , typename TItemId , class TExtractIcon >

STDMETHODIMP CCommonFolder< TSelf, TItemId, TExtractIcon >::GetCurFolder ( PIDLIST_ABSOLUTE *  pidl )

inlineoverride

Implements IPersistFolder2.

Definition at line 642 of file foldercommon.h.

    {
        if (pidl)
            *pidl = ILClone(m_shellPidl);
        if (!m_shellPidl)
            return S_FALSE;
        return S_OK;
    }

GetDefaultColumn()

template<class TSelf , typename TItemId , class TExtractIcon >

STDMETHODIMP CCommonFolder< TSelf, TItemId, TExtractIcon >::GetDefaultColumn ( DWORD  dwReserved, ULONG *  pSort, ULONG *  pDisplay  )

inlineoverride

Implements IShellFolder2.

Definition at line 591 of file foldercommon.h.

    {
        if (pSort)
            *pSort = 0;
        if (pDisplay)
            *pDisplay = 0;
        return S_OK;
    }

GetDefaultColumnState()

template<class TSelf , typename TItemId , class TExtractIcon >

STDMETHOD() CCommonFolder< TSelf, TItemId, TExtractIcon >::GetDefaultColumnState	(	UINT	iColumn,
		SHCOLSTATEF *	pcsFlags
	)

Implements IShellFolder2.

GetDefaultSearchGUID()

template<class TSelf , typename TItemId , class TExtractIcon >

STDMETHODIMP CCommonFolder< TSelf, TItemId, TExtractIcon >::GetDefaultSearchGUID ( GUID *  lpguid )

inlineoverride

Implements IShellFolder2.

Definition at line 579 of file foldercommon.h.

    {
        UNIMPLEMENTED;
        return E_NOTIMPL;
    }

GetDetailsEx()

template<class TSelf , typename TItemId , class TExtractIcon >

STDMETHOD() CCommonFolder< TSelf, TItemId, TExtractIcon >::GetDetailsEx	(	LPCITEMIDLIST	pidl,
		const SHCOLUMNID *	pscid,
		VARIANT *	pv
	)

GetDetailsOf()

template<class TSelf , typename TItemId , class TExtractIcon >

STDMETHOD() CCommonFolder< TSelf, TItemId, TExtractIcon >::GetDetailsOf	(	LPCITEMIDLIST	pidl,
		UINT	iColumn,
		SHELLDETAILS *	psd
	)

GetDisplayNameOf()

template<class TSelf , typename TItemId , class TExtractIcon >

STDMETHODIMP CCommonFolder< TSelf, TItemId, TExtractIcon >::GetDisplayNameOf ( LPCITEMIDLIST  pidl, SHGDNF  uFlags, STRRET *  lpName  )

inlineoverride

Definition at line 500 of file foldercommon.h.

    {
        const TItemId * info;
 
        TRACE("GetDisplayNameOf %p\n", pidl);
 
        HRESULT hr = GetInfoFromPidl(pidl, &info);
        if (FAILED_UNEXPECTEDLY(hr))
            return hr;
 
        if (GET_SHGDN_FOR(uFlags) & SHGDN_FOREDITING)
        {
            hr = MakeStrRetFromString(info->entryName, info->entryNameLength, lpName);
            if (FAILED_UNEXPECTEDLY(hr))
                return hr;
        }
 
        WCHAR path[MAX_PATH] = { 0 };
 
        if (GET_SHGDN_FOR(uFlags) & SHGDN_FORPARSING)
        {
            if (GET_SHGDN_RELATION(uFlags) != SHGDN_INFOLDER)
            {
                hr = GetFullName(m_shellPidl, uFlags, path, _countof(path));
                if (FAILED_UNEXPECTEDLY(hr))
                    return hr;
            }
        }
 
        PathAppendW(path, info->entryName);
 
        LPCITEMIDLIST pidlNext = ILGetNext(pidl);
        if (pidlNext && pidlNext->mkid.cb > 0)
        {
            LPITEMIDLIST pidlFirst = ILCloneFirst(pidl);
 
            CComPtr<IShellFolder> psfChild;
            hr = BindToObject(pidlFirst, NULL, IID_PPV_ARG(IShellFolder, &psfChild));
            if (FAILED_UNEXPECTEDLY(hr))
                return hr;
 
            WCHAR temp[MAX_PATH];
            STRRET childName;
 
            hr = psfChild->GetDisplayNameOf(pidlNext, uFlags | SHGDN_INFOLDER, &childName);
            if (FAILED_UNEXPECTEDLY(hr))
                return hr;
 
            hr = StrRetToBufW(&childName, pidlNext, temp, _countof(temp));
            if (FAILED_UNEXPECTEDLY(hr))
                return hr;
 
            PathAppendW(path, temp);
 
            ILFree(pidlFirst);
        }
 
        hr = MakeStrRetFromString(path, lpName);
        if (FAILED_UNEXPECTEDLY(hr))
            return hr;
 
        return S_OK;
    }

GetInfoFromPidl()

template<class TSelf , typename TItemId , class TExtractIcon >

virtual HRESULT CCommonFolder< TSelf, TItemId, TExtractIcon >::GetInfoFromPidl ( LPCITEMIDLIST  pcidl, const TItemId **  pentry  )

protectedvirtual

Reimplemented in CNtObjectFolder, and CRegistryFolder.

GetUIObjectOf()

template<class TSelf , typename TItemId , class TExtractIcon >

STDMETHODIMP CCommonFolder< TSelf, TItemId, TExtractIcon >::GetUIObjectOf ( HWND  hwndOwner, UINT  cidl, PCUITEMID_CHILD_ARRAY  apidl, REFIID  riid, UINT *  prgfInOut, void **  ppvOut  )

inlineoverride

Implements IShellFolder.

Definition at line 400 of file foldercommon.h.

    {
        DWORD res;
        TRACE("GetUIObjectOf\n");
 
        if (IsEqualIID(riid, IID_IContextMenu) ||
            IsEqualIID(riid, IID_IContextMenu2) ||
            IsEqualIID(riid, IID_IContextMenu3))
        {
            CComPtr<IContextMenu> pcm;
 
            HKEY keys[1];
 
            LPITEMIDLIST parent = m_shellPidl;
 
            CComPtr<IShellFolder> psfParent = this;
 
            LPCITEMIDLIST child;
 
            UINT nkeys = 0;
            if (cidl == 1 && IsSymLink(apidl[0]))
            {
                const TItemId * info;
                HRESULT hr = GetInfoFromPidl(apidl[0], &info);
                if (FAILED(hr))
                    return hr;
 
                LPITEMIDLIST target;
                hr = ResolveSymLink(info, &target);
                if (FAILED(hr))
                    return hr;
 
                CComPtr<IShellFolder> psfTarget;
                hr = ::SHBindToParent(target, IID_PPV_ARG(IShellFolder, &psfTarget), &child);
                if (FAILED(hr))
                {
                    ILFree(target);
                    return hr;
                }
 
                parent = ILClone(target);
                ILRemoveLastID(parent);
                psfParent = psfTarget;
 
                apidl = &child;
            }
 
            if (cidl == 1 && IsFolder(apidl[0]))
            {
                res = RegOpenKeyExW(HKEY_CLASSES_ROOT, L"Folder", 0, KEY_READ, &keys[0]);
                if (!NT_SUCCESS(res))
                    return HRESULT_FROM_WIN32(res);
                nkeys++;
            }
 
            HRESULT hr = CDefFolderMenu_Create2(parent, hwndOwner, cidl, apidl, psfParent, DefCtxMenuCallback, nkeys, keys, &pcm);
            for (UINT i = 0; i < nkeys; ++i)
                RegCloseKey(keys[i]);
            if (FAILED_UNEXPECTEDLY(hr))
                return hr;
 
            return pcm->QueryInterface(riid, ppvOut);
        }
 
        if (IsEqualIID(riid, IID_IExtractIconW))
        {
            return ShellObjectCreatorInit<TExtractIcon>(m_NtPath, m_shellPidl, cidl, apidl, riid, ppvOut);
        }
 
        if (IsEqualIID(riid, IID_IDataObject))
        {
            return CIDLData_CreateFromIDArray(m_shellPidl, cidl, apidl, (IDataObject**)ppvOut);
        }
 
        if (IsEqualIID(riid, IID_IQueryAssociations))
        {
            if (cidl == 1 && IsFolder(apidl[0]))
            {
                CComPtr<IQueryAssociations> pqa;
                HRESULT hr = AssocCreate(CLSID_QueryAssociations, IID_PPV_ARG(IQueryAssociations, &pqa));
                if (FAILED_UNEXPECTEDLY(hr))
                    return hr;
 
                hr = pqa->Init(ASSOCF_INIT_DEFAULTTOFOLDER, L"NTObjShEx.NTDirectory", NULL, hwndOwner);
                if (FAILED_UNEXPECTEDLY(hr))
                    return hr;
 
                return pqa->QueryInterface(riid, ppvOut);
            }
        }
 
        return E_NOTIMPL;
    }

Initialize()

template<class TSelf , typename TItemId , class TExtractIcon >

STDMETHODIMP CCommonFolder< TSelf, TItemId, TExtractIcon >::Initialize ( PCIDLIST_ABSOLUTE  pidl )

inlineoverride

Implements IPersistFolder.

Definition at line 632 of file foldercommon.h.

    {
        m_shellPidl = ILClone(pidl);
 
        StringCbCopyW(m_NtPath, sizeof(m_NtPath), L"\\");
 
        return S_OK;
    }

InternalBindToObject()

template<class TSelf , typename TItemId , class TExtractIcon >

STDMETHOD() CCommonFolder< TSelf, TItemId, TExtractIcon >::InternalBindToObject ( PWSTR  path, const TItemId *  info, LPITEMIDLIST  first, LPCITEMIDLIST  rest, LPITEMIDLIST  fullPidl, LPBC  pbcReserved, IShellFolder **  ppsfChild  )

protected

MapColumnToSCID()

template<class TSelf , typename TItemId , class TExtractIcon >

STDMETHOD() CCommonFolder< TSelf, TItemId, TExtractIcon >::MapColumnToSCID	(	UINT	iColumn,
		SHCOLUMNID *	pscid
	)

Implements IShellFolder2.

ParseDisplayName()

template<class TSelf , typename TItemId , class TExtractIcon >

STDMETHODIMP CCommonFolder< TSelf, TItemId, TExtractIcon >::ParseDisplayName ( HWND  hwndOwner, LPBC  pbcReserved, LPOLESTR  lpszDisplayName, ULONG *  pchEaten, LPITEMIDLIST *  ppidl, ULONG *  pdwAttributes  )

inlineoverride

Definition at line 84 of file foldercommon.h.

    {
        if (!ppidl)
            return E_POINTER;
 
        if (pchEaten)
            *pchEaten = 0;
 
        if (pdwAttributes)
            *pdwAttributes = 0;
 
        TRACE("CCommonFolder::ParseDisplayName name=%S (ntPath=%S)\n", lpszDisplayName, m_NtPath);
 
        const TItemId * info;
        IEnumIDList * it;
        HRESULT hr = EnumObjects(hwndOwner, SHCONTF_FOLDERS | SHCONTF_NONFOLDERS, &it);
        if (FAILED(hr))
            return hr;
 
        PWSTR end = StrChrW(lpszDisplayName, '\\');
        int length = end ? end - lpszDisplayName : wcslen(lpszDisplayName);
 
        while (TRUE)
        {
            hr = it->Next(1, ppidl, NULL);
 
            if (FAILED(hr))
                return hr;
 
            if (hr != S_OK)
                return HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND);
 
            hr = GetInfoFromPidl(*ppidl, &info);
            if (FAILED_UNEXPECTEDLY(hr))
                return hr;
 
            if (StrCmpNW(info->entryName, lpszDisplayName, length) == 0)
                break;
        }
 
        // if has remaining path to parse (and the path didn't just terminate in a backslash)
        if (end && wcslen(end) > 1)
        {
            CComPtr<IShellFolder> psfChild;
            hr = BindToObject(*ppidl, pbcReserved, IID_PPV_ARG(IShellFolder, &psfChild));
            if (FAILED_UNEXPECTEDLY(hr))
                return hr;
 
            LPITEMIDLIST child;
            hr = psfChild->ParseDisplayName(hwndOwner, pbcReserved, end + 1, pchEaten, &child, pdwAttributes);
            if (FAILED(hr))
                return hr;
 
            LPITEMIDLIST old = *ppidl;
            *ppidl = ILCombine(old, child);
            ILFree(old);
 
            // Count the path separator
            if (pchEaten)
                (*pchEaten) += 1;
        }
        else
        {
            if (pdwAttributes)
                *pdwAttributes = ConvertAttributes(info, pdwAttributes);
        }
 
        if (pchEaten)
            *pchEaten += wcslen(info->entryName);
 
        return S_OK;
    }

ResolveSymLink()

template<class TSelf , typename TItemId , class TExtractIcon >

STDMETHOD() CCommonFolder< TSelf, TItemId, TExtractIcon >::ResolveSymLink ( const TItemId *  info, LPITEMIDLIST *  fullPidl  )

inlineprotected

Definition at line 225 of file foldercommon.h.

    {
        return E_NOTIMPL;
    }

SetNameOf()

template<class TSelf , typename TItemId , class TExtractIcon >

STDMETHODIMP CCommonFolder< TSelf, TItemId, TExtractIcon >::SetNameOf ( HWND  hwnd, LPCITEMIDLIST  pidl, LPCOLESTR  lpszName, SHGDNF  uFlags, LPITEMIDLIST *  ppidlOut  )

inlineoverride

Definition at line 567 of file foldercommon.h.

    {
        UNIMPLEMENTED;
        return E_NOTIMPL;
    }

STDMETHOD_() [1/5]

template<class TSelf , typename TItemId , class TExtractIcon >

CCommonFolder< TSelf, TItemId, TExtractIcon >::STDMETHOD_ ( BOOL  , IsFolder    ) const

protected

STDMETHOD_() [2/5]

template<class TSelf , typename TItemId , class TExtractIcon >

CCommonFolder< TSelf, TItemId, TExtractIcon >::STDMETHOD_ ( BOOL  , IsFolder    )

inlineprotected

Definition at line 662 of file foldercommon.h.

    {
        const TItemId * info;
 
        HRESULT hr = GetInfoFromPidl(pcidl, &info);
        if (FAILED(hr))
            return hr;
 
        return IsFolder(info);
    }

STDMETHOD_() [3/5]

template<class TSelf , typename TItemId , class TExtractIcon >

CCommonFolder< TSelf, TItemId, TExtractIcon >::STDMETHOD_ ( BOOL  , IsSymLink    ) const

inlineprotected

Definition at line 686 of file foldercommon.h.

    {
        return FALSE;
    }

STDMETHOD_() [4/5]

template<class TSelf , typename TItemId , class TExtractIcon >

CCommonFolder< TSelf, TItemId, TExtractIcon >::STDMETHOD_ ( BOOL  , IsSymLink    )

inlineprotected

Definition at line 675 of file foldercommon.h.

    {
        const TItemId * info;
 
        HRESULT hr = GetInfoFromPidl(pcidl, &info);
        if (FAILED(hr))
            return hr;
 
        return IsSymLink(info);
    }

STDMETHOD_() [5/5]

template<class TSelf , typename TItemId , class TExtractIcon >

CCommonFolder< TSelf, TItemId, TExtractIcon >::STDMETHOD_ ( ULONG  , ConvertAttributes    ) const

protected

Member Data Documentation

m_NtPath

template<class TSelf , typename TItemId , class TExtractIcon >

WCHAR CCommonFolder< TSelf, TItemId, TExtractIcon >::m_NtPath[MAX_PATH]

protected

Definition at line 66 of file foldercommon.h.

m_shellPidl

template<class TSelf , typename TItemId , class TExtractIcon >

LPITEMIDLIST CCommonFolder< TSelf, TItemId, TExtractIcon >::m_shellPidl

protected

Definition at line 68 of file foldercommon.h.

PURE

template<class TSelf , typename TItemId , class TExtractIcon >

PULONG inMask CCommonFolder< TSelf, TItemId, TExtractIcon >::PURE

protected

Definition at line 660 of file foldercommon.h.

---

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

• dll/shellext/ntobjshex/foldercommon.h