CEnumIDListBase Class Reference

#include <CEnumIDListBase.h>

Inheritance diagram for CEnumIDListBase:

Collaboration diagram for CEnumIDListBase:

Public Member Functions
	CEnumIDListBase ()
virtual	~CEnumIDListBase ()
BOOL	AddToEnumList (LPITEMIDLIST pidl)
BOOL	DeleteList ()
BOOL	HasItemWithCLSID (LPITEMIDLIST pidl)
HRESULT	AppendItemsFromEnumerator (IEnumIDList *pEnum)
virtual HRESULT STDMETHODCALLTYPE	Next (ULONG celt, LPITEMIDLIST *rgelt, ULONG *pceltFetched)
virtual HRESULT STDMETHODCALLTYPE	Skip (ULONG celt)
virtual HRESULT STDMETHODCALLTYPE	Reset ()
virtual HRESULT STDMETHODCALLTYPE	Clone (IEnumIDList **ppenum)
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 IEnumIDList
HRESULT	Next ([in] ULONG celt, [out, size_is(celt), length_is(*pceltFetched)] PITEMID_CHILD *rgelt, [out] ULONG *pceltFetched)
HRESULT	Skip ([in] ULONG celt)
HRESULT	Reset ()
HRESULT	Clone ([out] IEnumIDList **ppenum)
Public Member Functions inherited from IUnknown
HRESULT	QueryInterface ([in] REFIID riid, [out, iid_is(riid)] void **ppvObject)
ULONG	AddRef ()
ULONG	Release ()

Private Attributes
ENUMLIST *	mpFirst
ENUMLIST *	mpLast
ENUMLIST *	mpCurrent

Additional Inherited Members
Public Types inherited from IEnumIDList
typedef IEnumIDList *	LPENUMIDLIST
Public Types inherited from IUnknown
typedef IUnknown *	LPUNKNOWN
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 26 of file CEnumIDListBase.h.

Constructor & Destructor Documentation

CEnumIDListBase()

CEnumIDListBase::CEnumIDListBase

(

)

Definition at line 25 of file CEnumIDListBase.cpp.

                                 :
    mpFirst(NULL),
    mpLast(NULL),
    mpCurrent(NULL)
{
}

~CEnumIDListBase()

CEnumIDListBase::~CEnumIDListBase ( )

virtual

Definition at line 32 of file CEnumIDListBase.cpp.

{
    DeleteList();
}

Member Function Documentation

AddToEnumList()

BOOL CEnumIDListBase::AddToEnumList

(

LPITEMIDLIST

pidl

)

Definition at line 40 of file CEnumIDListBase.cpp.

{
    ENUMLIST *pNew;
 
    TRACE("(%p)->(pidl=%p)\n", this, pidl);
 
    if (!pidl)
        return FALSE;
 
    pNew = static_cast<ENUMLIST *>(SHAlloc(sizeof(ENUMLIST)));
    if (pNew)
    {
      /*set the next pointer */
      pNew->pNext = NULL;
      pNew->pidl = pidl;
 
      /*is This the first item in the list? */
      if (!mpFirst)
      {
        mpFirst = pNew;
        mpCurrent = pNew;
      }
 
      if (mpLast)
      {
        /*add the new item to the end of the list */
        mpLast->pNext = pNew;
      }
 
      /*update the last item pointer */
      mpLast = pNew;
      TRACE("-- (%p)->(first=%p, last=%p)\n", this, mpFirst, mpLast);
      return TRUE;
    }
    return FALSE;
}

Referenced by CFileSysEnum::_AddFindResult(), CDesktopFolderEnum::AddItemsFromClassicStartMenuKey(), CRegFolderEnum::AddItemsFromKey(), AppendItemsFromEnumerator(), CRecycleBinEnum::CBEnumRecycleBin(), CPrintersEnum::CreatePrintersEnumList(), CNetFolderEnum::EnumerateRec(), CDesktopFolderEnum::Initialize(), CDrivesFolderEnum::Initialize(), and CControlPanelEnum::RegisterCPanelApp().

AppendItemsFromEnumerator()

HRESULT CEnumIDListBase::AppendItemsFromEnumerator

(

IEnumIDList *

pEnum

)

Definition at line 126 of file CEnumIDListBase.cpp.

{
    LPITEMIDLIST pidl;
    DWORD dwFetched;
 
    if (!pEnum)
        return E_INVALIDARG;
 
    pEnum->Reset();
 
    while((S_OK == pEnum->Next(1, &pidl, &dwFetched)) && dwFetched)
        AddToEnumList(pidl);
 
    return S_OK;
}

Referenced by CControlPanelEnum::Initialize(), CDesktopFolderEnum::Initialize(), and CDrivesFolderEnum::Initialize().

Clone()

HRESULT WINAPI CEnumIDListBase::Clone ( IEnumIDList **  ppenum )

virtual

Implements IEnumIDList.

Definition at line 222 of file CEnumIDListBase.cpp.

{
    TRACE("(%p)->() to (%p)->() E_NOTIMPL\n", this, ppenum);
    return E_NOTIMPL;
}

DeleteList()

BOOL CEnumIDListBase::DeleteList

(

)

Definition at line 80 of file CEnumIDListBase.cpp.

{
    ENUMLIST                    *pDelete;
 
    TRACE("(%p)->()\n", this);
 
    while (mpFirst)
    {
        pDelete = mpFirst;
        mpFirst = pDelete->pNext;
        SHFree(pDelete->pidl);
        SHFree(pDelete);
    }
    mpFirst = NULL;
    mpLast = NULL;
    mpCurrent = NULL;
    return TRUE;
}

Referenced by ~CEnumIDListBase().

HasItemWithCLSID()

BOOL CEnumIDListBase::HasItemWithCLSID

(

LPITEMIDLIST

pidl

)

Definition at line 102 of file CEnumIDListBase.cpp.

{
    ENUMLIST *pCur;
    IID *ptr = _ILGetGUIDPointer(pidl);
 
    if (ptr)
    {
        REFIID refid = *ptr;
        pCur = mpFirst;
 
        while(pCur)
        {
            LPGUID curid = _ILGetGUIDPointer(pCur->pidl);
            if (curid && IsEqualGUID(*curid, refid))
            {
                return TRUE;
            }
            pCur = pCur->pNext;
        }
    }
 
    return FALSE;
}

Referenced by CDesktopFolderEnum::AddItemsFromClassicStartMenuKey(), and CDesktopFolderEnum::Initialize().

Next()

HRESULT WINAPI CEnumIDListBase::Next ( ULONG  celt, LPITEMIDLIST *  rgelt, ULONG *  pceltFetched  )

virtual

Definition at line 146 of file CEnumIDListBase.cpp.

{
    ULONG    i;
    HRESULT  hr = S_OK;
    LPITEMIDLIST  temp;
 
    TRACE("(%p)->(%d,%p, %p)\n", this, celt, rgelt, pceltFetched);
 
/* It is valid to leave pceltFetched NULL when celt is 1. Some of explorer's
 * subsystems actually use it (and so may a third party browser)
 */
    if(pceltFetched)
      *pceltFetched = 0;
 
    *rgelt=0;
 
    if(celt > 1 && !pceltFetched)
    { return E_INVALIDARG;
    }
 
    if(celt > 0 && !mpCurrent)
    { return S_FALSE;
    }
 
    for(i = 0; i < celt; i++)
    { if(!mpCurrent)
        break;
 
      temp = ILClone(mpCurrent->pidl);
      rgelt[i] = temp;
      mpCurrent = mpCurrent->pNext;
    }
    if(pceltFetched)
    {  *pceltFetched = i;
    }
 
    return hr;
}

Reset()

HRESULT WINAPI CEnumIDListBase::Reset ( )

virtual

Implements IEnumIDList.

Definition at line 212 of file CEnumIDListBase.cpp.

{
    TRACE("(%p)\n", this);
    mpCurrent = mpFirst;
    return S_OK;
}

Skip()

HRESULT WINAPI CEnumIDListBase::Skip ( ULONG  celt )

virtual

Implements IEnumIDList.

Definition at line 191 of file CEnumIDListBase.cpp.

{
    DWORD    dwIndex;
    HRESULT  hr = S_OK;
 
    TRACE("(%p)->(%u)\n", this, celt);
 
    for(dwIndex = 0; dwIndex < celt; dwIndex++)
    { if(!mpCurrent)
      { hr = S_FALSE;
        break;
      }
      mpCurrent = mpCurrent->pNext;
    }
    return hr;
}

Member Data Documentation

mpCurrent

ENUMLIST* CEnumIDListBase::mpCurrent

private

Definition at line 33 of file CEnumIDListBase.h.

Referenced by AddToEnumList(), DeleteList(), Next(), Reset(), and Skip().

mpFirst

ENUMLIST* CEnumIDListBase::mpFirst

private

Definition at line 31 of file CEnumIDListBase.h.

Referenced by AddToEnumList(), DeleteList(), HasItemWithCLSID(), and Reset().

mpLast

ENUMLIST* CEnumIDListBase::mpLast

private

Definition at line 32 of file CEnumIDListBase.h.

Referenced by AddToEnumList(), and DeleteList().

---

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

• dll/win32/shell32/CEnumIDListBase.h
• dll/win32/shell32/CEnumIDListBase.cpp