CEnumString Class Reference

Inheritance diagram for CEnumString:

Collaboration diagram for CEnumString:

Public Member Functions
	CEnumString ()
virtual	~CEnumString ()
VOID	SetList (UINT nCount, LPWSTR *pList)
STDMETHODIMP	QueryInterface (REFIID iid, VOID **ppv) override
	STDMETHODIMP_ (ULONG) AddRef() override
	STDMETHODIMP_ (ULONG) Release() override
STDMETHODIMP	Next (ULONG celt, LPWSTR *rgelt, ULONG *pceltFetched) override
STDMETHODIMP	Skip (ULONG celt) override
STDMETHODIMP	Reset () override
STDMETHODIMP	Clone (IEnumString **ppenum) override
STDMETHODIMP	Expand (PCWSTR pszExpand) override
STDMETHODIMP	GetOptions (DWORD *pdwFlag) override
STDMETHODIMP	SetOptions (DWORD dwFlag) override
Public Member Functions inherited from IEnumString
HRESULT	Next ([in] ULONG celt, [out, size_is(celt), length_is(*pceltFetched)] LPOLESTR *rgelt, [out] ULONG *pceltFetched)
HRESULT	RemoteNext ([in] ULONG celt, [out, size_is(celt), length_is(*pceltFetched)] LPOLESTR *rgelt, [out] ULONG *pceltFetched)
HRESULT	Skip ([in] ULONG celt)
HRESULT	Reset ()
HRESULT	Clone ([out] IEnumString **ppenum)
Public Member Functions inherited from IUnknown
HRESULT	QueryInterface ([in] REFIID riid, [out, iid_is(riid)] void **ppvObject)
ULONG	AddRef ()
ULONG	Release ()

Protected Attributes
ULONG	m_cRefs
UINT	m_nIndex
UINT	m_nCount
LPWSTR *	m_pList

Additional Inherited Members
Public Types inherited from IEnumString
typedef IEnumString *	LPENUMSTRING
Public Types inherited from IUnknown
typedef IUnknown *	LPUNKNOWN

Detailed Description

Definition at line 41 of file IAutoComplete.cpp.

Constructor & Destructor Documentation

CEnumString()

CEnumString::CEnumString ( )

inline

Definition at line 44 of file IAutoComplete.cpp.

                  : m_cRefs(0), m_nIndex(0), m_nCount(0), m_pList(NULL)
    {
        trace("CEnumString::CEnumString(%p)\n", this);
    }

~CEnumString()

virtual CEnumString::~CEnumString ( )

inlinevirtual

Definition at line 49 of file IAutoComplete.cpp.

    {
        trace("CEnumString::~CEnumString(%p)\n", this);
        for (UINT i = 0; i < m_nCount; ++i)
        {
            CoTaskMemFree(m_pList[i]);
            m_pList[i] = NULL;
        }
        CoTaskMemFree(m_pList);
    }

Member Function Documentation

Clone()

STDMETHODIMP CEnumString::Clone ( IEnumString **  ppenum )

inlineoverride

Implements IEnumString.

Definition at line 132 of file IAutoComplete.cpp.

    {
        trace("CEnumString::Clone()\n");
        return E_NOTIMPL;
    }

Expand()

STDMETHODIMP CEnumString::Expand ( PCWSTR  pszExpand )

inlineoverride

Definition at line 138 of file IAutoComplete.cpp.

    {
        trace("CEnumString::Expand(%S)\n", pszExpand);
        s_bExpand = TRUE;
        s_strExpand = pszExpand;
        return S_OK;
    }

GetOptions()

STDMETHODIMP CEnumString::GetOptions ( DWORD *  pdwFlag )

inlineoverride

Definition at line 145 of file IAutoComplete.cpp.

    {
        trace("CEnumString::GetOption(%p)\n", pdwFlag);
        return S_OK;
    }

Next()

STDMETHODIMP CEnumString::Next ( ULONG  celt, LPWSTR *  rgelt, ULONG *  pceltFetched  )

inlineoverride

Definition at line 102 of file IAutoComplete.cpp.

    {
        if (rgelt)
            *rgelt = NULL;
        if (pceltFetched)
            *pceltFetched = 0;
        if (celt != 1 || !rgelt || !pceltFetched)
            return E_INVALIDARG;
        if (m_nIndex >= m_nCount)
            return S_FALSE;
 
        SHStrDupW(m_pList[m_nIndex], rgelt);
        ++m_nIndex;
        if (!*rgelt)
            return E_OUTOFMEMORY;
        *pceltFetched = 1;
        return S_OK;
    }

QueryInterface()

STDMETHODIMP CEnumString::QueryInterface ( REFIID  iid, VOID **  ppv  )

inlineoverride

Implements IUnknown.

Definition at line 66 of file IAutoComplete.cpp.

    {
        if (iid == IID_IUnknown || iid == IID_IEnumString)
        {
            trace("IID_IEnumString\n");
            AddRef();
            *ppv = static_cast<IEnumString *>(this);
            return S_OK;
        }
        if (iid == IID_IACList || iid == IID_IACList2)
        {
            trace("IID_IACList2\n");
            AddRef();
            *ppv = static_cast<IACList2 *>(this);
            return S_OK;
        }
        return E_NOINTERFACE;
    }

Reset()

STDMETHODIMP CEnumString::Reset ( )

inlineoverride

Implements IEnumString.

Definition at line 125 of file IAutoComplete.cpp.

    {
        trace("CEnumString::Reset\n");
        m_nIndex = 0;
        s_bReset = TRUE;
        return S_OK;
    }

SetList()

VOID CEnumString::SetList ( UINT  nCount, LPWSTR *  pList  )

inline

Definition at line 60 of file IAutoComplete.cpp.

    {
        m_nCount = nCount;
        m_pList = pList;
    }

SetOptions()

STDMETHODIMP CEnumString::SetOptions ( DWORD  dwFlag )

inlineoverride

Definition at line 150 of file IAutoComplete.cpp.

    {
        trace("CEnumString::SetOption(0x%lX)\n", dwFlag);
        return S_OK;
    }

Skip()

STDMETHODIMP CEnumString::Skip ( ULONG  celt )

inlineoverride

Implements IEnumString.

Definition at line 120 of file IAutoComplete.cpp.

    {
        trace("CEnumString::Skip(%lu)\n", celt);
        return E_NOTIMPL;
    }

STDMETHODIMP_() [1/2]

CEnumString::STDMETHODIMP_ ( ULONG  )

inlineoverride

Definition at line 84 of file IAutoComplete.cpp.

    {
        //trace("CEnumString::AddRef\n");
        ++m_cRefs;
        return m_cRefs;
    }

STDMETHODIMP_() [2/2]

CEnumString::STDMETHODIMP_ ( ULONG  )

inlineoverride

Definition at line 90 of file IAutoComplete.cpp.

    {
        //trace("CEnumString::Release\n");
        --m_cRefs;
        if (m_cRefs == 0)
        {
            delete this;
            return 0;
        }
        return m_cRefs;
    }

Member Data Documentation

m_cRefs

ULONG CEnumString::m_cRefs

protected

Definition at line 157 of file IAutoComplete.cpp.

Referenced by STDMETHODIMP_().

m_nCount

UINT CEnumString::m_nCount

protected

Definition at line 158 of file IAutoComplete.cpp.

Referenced by Next(), SetList(), and ~CEnumString().

m_nIndex

UINT CEnumString::m_nIndex

protected

Definition at line 158 of file IAutoComplete.cpp.

Referenced by Next(), and Reset().

m_pList

LPWSTR* CEnumString::m_pList

protected

Definition at line 159 of file IAutoComplete.cpp.

Referenced by Next(), SetList(), and ~CEnumString().

---

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

• modules/rostests/apitests/browseui/IAutoComplete.cpp