CNetFolder Class Reference

#include <CNetFolder.h>

Inheritance diagram for CNetFolder:

Collaboration diagram for CNetFolder:

Public Member Functions
	CNetFolder ()
	~CNetFolder ()
STDMETHOD()	ParseDisplayName (HWND hwndOwner, LPBC pbc, LPOLESTR lpszDisplayName, DWORD *pchEaten, PIDLIST_RELATIVE *ppidl, DWORD *pdwAttributes) override
STDMETHOD()	EnumObjects (HWND hwndOwner, DWORD dwFlags, LPENUMIDLIST *ppEnumIDList) override
STDMETHOD()	BindToObject (PCUIDLIST_RELATIVE pidl, LPBC pbcReserved, REFIID riid, LPVOID *ppvOut) override
STDMETHOD()	BindToStorage (PCUIDLIST_RELATIVE pidl, LPBC pbcReserved, REFIID riid, LPVOID *ppvOut) override
STDMETHOD()	CompareIDs (LPARAM lParam, PCUIDLIST_RELATIVE pidl1, PCUIDLIST_RELATIVE pidl2) override
STDMETHOD()	CreateViewObject (HWND hwndOwner, REFIID riid, LPVOID *ppvOut) override
STDMETHOD()	GetAttributesOf (UINT cidl, PCUITEMID_CHILD_ARRAY apidl, DWORD *rgfInOut) override
STDMETHOD()	GetUIObjectOf (HWND hwndOwner, UINT cidl, PCUITEMID_CHILD_ARRAY apidl, REFIID riid, UINT *prgfInOut, LPVOID *ppvOut) override
STDMETHOD()	GetDisplayNameOf (PCUITEMID_CHILD pidl, DWORD dwFlags, LPSTRRET strRet) override
STDMETHOD()	SetNameOf (HWND hwndOwner, PCUITEMID_CHILD pidl, LPCOLESTR lpName, DWORD dwFlags, PITEMID_CHILD *pPidlOut) override
STDMETHOD()	GetDefaultSearchGUID (GUID *pguid) override
STDMETHOD()	EnumSearches (IEnumExtraSearch **ppenum) override
STDMETHOD()	GetDefaultColumn (DWORD dwRes, ULONG *pSort, ULONG *pDisplay) override
STDMETHOD()	GetDefaultColumnState (UINT iColumn, DWORD *pcsFlags) override
STDMETHOD()	GetDetailsEx (PCUITEMID_CHILD pidl, const SHCOLUMNID *pscid, VARIANT *pv) override
STDMETHOD()	GetDetailsOf (PCUITEMID_CHILD pidl, UINT iColumn, SHELLDETAILS *psd) override
STDMETHOD()	MapColumnToSCID (UINT column, SHCOLUMNID *pscid) override
STDMETHOD()	GetClassID (CLSID *lpClassId) override
STDMETHOD()	Initialize (PCIDLIST_ABSOLUTE pidl) override
STDMETHOD()	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 ()
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)

Private Attributes
LPITEMIDLIST	pidlRoot

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
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)
Public Attributes inherited from ATL::CComObjectRootBase
LONG	m_dwRef

Detailed Description

Definition at line 27 of file CNetFolder.h.

Constructor & Destructor Documentation

CNetFolder()

CNetFolder::CNetFolder

(

)

Definition at line 210 of file CNetFolder.cpp.

{
    pidlRoot = NULL;
}

~CNetFolder()

CNetFolder::~CNetFolder

(

)

Definition at line 215 of file CNetFolder.cpp.

{
    if (pidlRoot)
        SHFree(pidlRoot);
}

Member Function Documentation

BindToObject()

HRESULT WINAPI CNetFolder::BindToObject ( PCUIDLIST_RELATIVE  pidl, LPBC  pbcReserved, REFIID  riid, LPVOID *  ppvOut  )

override

Definition at line 274 of file CNetFolder.cpp.

{
#ifdef HACKY_UNC_PATHS
    /* Create the target folder info */
    PERSIST_FOLDER_TARGET_INFO pfti = {0};
    pfti.dwAttributes = -1;
    pfti.csidl = -1;
    StringCchCopyW(pfti.szTargetParsingName, MAX_PATH, (WCHAR*)pidl->mkid.abID);
 
    return SHELL32_BindToSF(pidlRoot, &pfti, pidl, &CLSID_ShellFSFolder, riid, ppvOut);
#else
    return E_NOTIMPL;
#endif
}

BindToStorage()

HRESULT WINAPI CNetFolder::BindToStorage ( PCUIDLIST_RELATIVE  pidl, LPBC  pbcReserved, REFIID  riid, LPVOID *  ppvOut  )

override

Definition at line 292 of file CNetFolder.cpp.

{
    FIXME("(%p)->(pidl=%p,%p,%s,%p) stub\n", this,
          pidl, pbcReserved, shdebugstr_guid (&riid), ppvOut);
 
    *ppvOut = NULL;
    return E_NOTIMPL;
}

CompareIDs()

HRESULT WINAPI CNetFolder::CompareIDs ( LPARAM  lParam, PCUIDLIST_RELATIVE  pidl1, PCUIDLIST_RELATIVE  pidl2  )

override

Implements IShellFolder.

Definition at line 305 of file CNetFolder.cpp.

{
    return E_NOTIMPL;
}

CreateViewObject()

HRESULT WINAPI CNetFolder::CreateViewObject ( HWND  hwndOwner, REFIID  riid, LPVOID *  ppvOut  )

override

Definition at line 313 of file CNetFolder.cpp.

{
    CComPtr<IShellView> pShellView;
    HRESULT hr = E_INVALIDARG;
 
    TRACE("(%p)->(hwnd=%p,%s,%p)\n", this,
          hwndOwner, shdebugstr_guid (&riid), ppvOut);
 
    if (!ppvOut)
        return hr;
 
    *ppvOut = NULL;
 
    if (IsEqualIID(riid, IID_IDropTarget))
    {
        WARN("IDropTarget not implemented\n");
        hr = E_NOTIMPL;
    }
    else if (IsEqualIID(riid, IID_IContextMenu))
    {
        WARN("IContextMenu not implemented\n");
        hr = E_NOTIMPL;
    }
    else if (IsEqualIID(riid, IID_IShellView))
    {
            SFV_CREATE sfvparams = {sizeof(SFV_CREATE), this};
            hr = SHCreateShellFolderView(&sfvparams, (IShellView**)ppvOut);
    }
    TRACE("-- (%p)->(interface=%p)\n", this, ppvOut);
    return hr;
}

EnumObjects()

HRESULT WINAPI CNetFolder::EnumObjects ( HWND  hwndOwner, DWORD  dwFlags, LPENUMIDLIST *  ppEnumIDList  )

override

Definition at line 266 of file CNetFolder.cpp.

{
    return ShellObjectCreatorInit<CNetFolderEnum>(hwndOwner, dwFlags, IID_PPV_ARG(IEnumIDList, ppEnumIDList));
}

EnumSearches()

HRESULT WINAPI CNetFolder::EnumSearches ( IEnumExtraSearch **  ppenum )

override

Implements IShellFolder2.

Definition at line 486 of file CNetFolder.cpp.

{
    FIXME("(%p)\n", this);
    return E_NOTIMPL;
}

GetAttributesOf()

HRESULT WINAPI CNetFolder::GetAttributesOf ( UINT  cidl, PCUITEMID_CHILD_ARRAY  apidl, DWORD *  rgfInOut  )

override

Definition at line 348 of file CNetFolder.cpp.

{
    static const DWORD dwNethoodAttributes =
        SFGAO_STORAGE | SFGAO_HASPROPSHEET | SFGAO_STORAGEANCESTOR |
        SFGAO_FILESYSANCESTOR | SFGAO_FOLDER | SFGAO_FILESYSTEM | SFGAO_HASSUBFOLDER | SFGAO_CANRENAME | SFGAO_CANDELETE;
    HRESULT hr = S_OK;
 
    TRACE("(%p)->(cidl=%d apidl=%p mask=%p (0x%08x))\n", this,
          cidl, apidl, rgfInOut, rgfInOut ? *rgfInOut : 0);
 
    if (!rgfInOut)
        return E_INVALIDARG;
    if (cidl && !apidl)
        return E_INVALIDARG;
 
    if (*rgfInOut == 0)
        *rgfInOut = ~0;
 
    if(cidl == 0)
        *rgfInOut = dwNethoodAttributes;
    else
    {
        /* FIXME: Implement when enumerating items is implemented */
#ifdef HACKY_UNC_PATHS
        *rgfInOut = SFGAO_FILESYSTEM | SFGAO_CANLINK | SFGAO_FOLDER | SFGAO_HASSUBFOLDER | SFGAO_FILESYSANCESTOR;
#endif
    }
 
    /* make sure SFGAO_VALIDATE is cleared, some apps depend on that */
    *rgfInOut &= ~SFGAO_VALIDATE;
 
    TRACE("-- result=0x%08x\n", *rgfInOut);
    return hr;
}

GetClassID()

HRESULT WINAPI CNetFolder::GetClassID ( CLSID *  lpClassId )

override

Implements IPersist.

Definition at line 548 of file CNetFolder.cpp.

{
    TRACE("(%p)\n", this);
 
    if (!lpClassId)
        return E_POINTER;
 
    *lpClassId = CLSID_NetworkPlaces;
 
    return S_OK;
}

GetCurFolder()

HRESULT WINAPI CNetFolder::GetCurFolder ( PIDLIST_ABSOLUTE *  pidl )

override

Implements IPersistFolder2.

Definition at line 577 of file CNetFolder.cpp.

{
    TRACE("(%p)->(%p)\n", this, pidl);
 
    if (!pidl)
        return E_POINTER;
 
    *pidl = ILClone(pidlRoot);
 
    return S_OK;
}

GetDefaultColumn()

HRESULT WINAPI CNetFolder::GetDefaultColumn ( DWORD  dwRes, ULONG *  pSort, ULONG *  pDisplay  )

override

Implements IShellFolder2.

Definition at line 492 of file CNetFolder.cpp.

{
    TRACE("(%p)\n", this);
 
    if (pSort)
        *pSort = 0;
    if (pDisplay)
        *pDisplay = 0;
 
    return S_OK;
}

GetDefaultColumnState()

HRESULT WINAPI CNetFolder::GetDefaultColumnState ( UINT  iColumn, DWORD *  pcsFlags  )

override

Implements IShellFolder2.

Definition at line 504 of file CNetFolder.cpp.

{
    TRACE("(%p)\n", this);
 
    if (!pcsFlags || iColumn >= NETWORKPLACESSHELLVIEWCOLUMNS)
        return E_INVALIDARG;
    *pcsFlags = NetworkPlacesSFHeader[iColumn].colstate;
    return S_OK;
}

GetDefaultSearchGUID()

HRESULT WINAPI CNetFolder::GetDefaultSearchGUID ( GUID *  pguid )

override

Implements IShellFolder2.

Definition at line 480 of file CNetFolder.cpp.

{
    FIXME("(%p)\n", this);
    return E_NOTIMPL;
}

GetDetailsEx()

HRESULT WINAPI CNetFolder::GetDetailsEx ( PCUITEMID_CHILD  pidl, const SHCOLUMNID *  pscid, VARIANT *  pv  )

override

Implements IShellFolder2.

Definition at line 514 of file CNetFolder.cpp.

{
    FIXME("(%p)\n", this);
    return E_NOTIMPL;
}

GetDetailsOf()

HRESULT WINAPI CNetFolder::GetDetailsOf ( PCUITEMID_CHILD  pidl, UINT  iColumn, SHELLDETAILS *  psd  )

override

Implements IShellFolder2.

Definition at line 520 of file CNetFolder.cpp.

{
    if (iColumn >= NETWORKPLACESSHELLVIEWCOLUMNS)
        return E_FAIL;
 
    psd->fmt = NetworkPlacesSFHeader[iColumn].fmt;
    psd->cxChar = NetworkPlacesSFHeader[iColumn].cxChar;
    if (pidl == NULL)
        return SHSetStrRet(&psd->str, NetworkPlacesSFHeader[iColumn].colnameid);
 
    if (iColumn == COLUMN_NAME)
        return GetDisplayNameOf(pidl, SHGDN_NORMAL, &psd->str);
 
    FIXME("(%p)->(%p %i %p)\n", this, pidl, iColumn, psd);
 
    return E_NOTIMPL;
}

GetDisplayNameOf()

HRESULT WINAPI CNetFolder::GetDisplayNameOf ( PCUITEMID_CHILD  pidl, DWORD  dwFlags, LPSTRRET  strRet  )

override

Definition at line 449 of file CNetFolder.cpp.

{
    if (!strRet || !pidl || !pidl->mkid.cb)
        return E_INVALIDARG;
 
#ifdef HACKY_UNC_PATHS
    return SHSetStrRet(strRet, (LPCWSTR)pidl->mkid.abID);
#endif
    return E_NOTIMPL;
}

Referenced by GetDetailsOf().

GetUIObjectOf()

HRESULT WINAPI CNetFolder::GetUIObjectOf ( HWND  hwndOwner, UINT  cidl, PCUITEMID_CHILD_ARRAY  apidl, REFIID  riid, UINT *  prgfInOut, LPVOID *  ppvOut  )

override

Definition at line 395 of file CNetFolder.cpp.

{
    LPVOID pObj = NULL;
    HRESULT hr = E_INVALIDARG;
 
    TRACE("(%p)->(%p,%u,apidl=%p,%s,%p,%p)\n", this,
          hwndOwner, cidl, apidl, shdebugstr_guid (&riid), prgfInOut, ppvOut);
 
    if (!ppvOut)
        return hr;
 
    *ppvOut = NULL;
 
    if (IsEqualIID(riid, IID_IContextMenu) && (cidl >= 1))
    {
        IContextMenu * pCm = NULL;
        HKEY hkey;
        UINT cKeys = 0;
        AddClassKeyToArray(L"Folder", &hkey, &cKeys);
        hr = CDefFolderMenu_Create2(pidlRoot, hwndOwner, cidl, apidl, this, NetFolderMenuCallback, cKeys, &hkey, &pCm);
        pObj = pCm;
    }
    else if (IsEqualIID(riid, IID_IDataObject) && (cidl >= 1))
    {
        IDataObject * pDo = NULL;
        hr = IDataObject_Constructor (hwndOwner, pidlRoot, apidl, cidl, TRUE, &pDo);
        pObj = pDo;
    }
    else if ((IsEqualIID(riid, IID_IExtractIconA) || IsEqualIID(riid, IID_IExtractIconW)) && (cidl == 1))
    {
        hr = CNetFolderExtractIcon_CreateInstance(apidl[0], riid, &pObj);
    }
    else if (IsEqualIID(riid, IID_IDropTarget) && (cidl >= 1))
    {
        IDropTarget * pDt = NULL;
        hr = this->QueryInterface(IID_PPV_ARG(IDropTarget, &pDt));
        pObj = pDt;
    }
    else
        hr = E_NOINTERFACE;
 
    if (SUCCEEDED(hr) && !pObj)
        hr = E_OUTOFMEMORY;
 
    *ppvOut = pObj;
    TRACE("(%p)->hr=0x%08x\n", this, hr);
    return hr;
}

Initialize()

HRESULT WINAPI CNetFolder::Initialize ( PCIDLIST_ABSOLUTE  pidl )

override

Implements IPersistFolder.

Definition at line 565 of file CNetFolder.cpp.

{
    if (pidlRoot)
        SHFree((LPVOID)pidlRoot);
 
    pidlRoot = ILClone(pidl);
    return S_OK;
}

MapColumnToSCID()

HRESULT WINAPI CNetFolder::MapColumnToSCID ( UINT  column, SHCOLUMNID *  pscid  )

override

Implements IShellFolder2.

Definition at line 538 of file CNetFolder.cpp.

{
    FIXME("(%p)\n", this);
 
    return E_NOTIMPL;
}

ParseDisplayName()

HRESULT WINAPI CNetFolder::ParseDisplayName ( HWND  hwndOwner, LPBC  pbc, LPOLESTR  lpszDisplayName, DWORD *  pchEaten, PIDLIST_RELATIVE *  ppidl, DWORD *  pdwAttributes  )

override

Definition at line 224 of file CNetFolder.cpp.

{
    HRESULT hr = E_UNEXPECTED;
#ifdef HACKY_UNC_PATHS
    /* FIXME: the code below is an ugly hack */
 
    /* Can we use a CFSFolder on that path? */
    DWORD attrs = GetFileAttributes(lpszDisplayName);
    if ((attrs & FILE_ATTRIBUTE_DIRECTORY))
    {
        if (pchEaten)
            *pchEaten = 0;        /* strange but like the original */
 
        /* YES WE CAN */
 
        /* Create our hacky pidl */
        LPITEMIDLIST pidl = ILCreateFromNetworkPlaceW(lpszDisplayName);
 
        *ppidl = pidl;
        if (pdwAttributes)
            *pdwAttributes = SFGAO_FILESYSTEM | SFGAO_CANLINK | SFGAO_FOLDER | SFGAO_HASSUBFOLDER | SFGAO_FILESYSANCESTOR;
        return S_OK;
    }
#endif
 
    TRACE("(%p)->(HWND=%p,%p,%p=%s,%p,pidl=%p,%p)\n", this,
          hwndOwner, pbcReserved, lpszDisplayName, debugstr_w (lpszDisplayName),
          pchEaten, ppidl, pdwAttributes);
 
    *ppidl = 0;
    if (pchEaten)
        *pchEaten = 0;        /* strange but like the original */
 
    TRACE("(%p)->(-- ret=0x%08x)\n", this, hr);
 
    return hr;
}

SetNameOf()

HRESULT WINAPI CNetFolder::SetNameOf ( HWND  hwndOwner, PCUITEMID_CHILD  pidl, LPCOLESTR  lpName, DWORD  dwFlags, PITEMID_CHILD *  pPidlOut  )

override

Implements IShellFolder.

Definition at line 472 of file CNetFolder.cpp.

{
    FIXME("(%p)->(%p,pidl=%p,%s,%u,%p)\n", this,
          hwndOwner, pidl, debugstr_w (lpName), dwFlags, pPidlOut);
    return E_FAIL;
}

Member Data Documentation

pidlRoot

LPITEMIDLIST CNetFolder::pidlRoot

private

Definition at line 35 of file CNetFolder.h.

Referenced by BindToObject(), CNetFolder(), GetCurFolder(), GetUIObjectOf(), Initialize(), and ~CNetFolder().

---

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

• dll/win32/shell32/folders/CNetFolder.h
• dll/win32/shell32/folders/CNetFolder.cpp