CEnumerator 類別

使用 OLE DB 列舉值物件，其會 公開 ISourcesRowset 介面，以傳回描述所有資料來源和列舉值的資料列集。

語法

class CEnumerator :
   public CAccessorRowset< CAccessor <CEnumeratorAccessor >>

需求

標頭檔：atldbcli.h

成員

方法

名稱	描述
Find	搜尋可用的提供者（資料來源），尋找具有指定名稱的提供者。
GetMoniker	擷 IMoniker 取目前記錄的 介面。
Open	開啟列舉值。

備註

您可以從這個類別間接擷取 ISourcesRowset 資料。

CEnumerator::Find

在可用提供者中尋找指定的名稱。

語法

bool Find(TCHAR* szSearchName) throw();

參數

szSearchName
[in] 要搜尋的名稱。

傳回值

true 如果找到名稱，則為 。 否則為 false。

備註

此名稱會對應至 SOURCES_NAME ISourcesRowset 介面的成員 。

CEnumerator::GetMoniker

剖析顯示名稱，以擷取可轉換成 Moniker 之字串的元件。

語法

HRESULT GetMoniker(LPMONIKER* ppMoniker) const throw();

HRESULT GetMoniker(LPMONIKER* ppMoniker,
   LPCTSTR lpszDisplayName) const throw();

參數

ppMoniker
[out]從目前資料列的顯示名稱 （ CEnumeratorAccessor：：m_szParseName ） 剖析的 Moniker。

lpszDisplayName
[in]要剖析的顯示名稱。

傳回值

標準 HRESULT。

CEnumerator::Open

如果指定列舉值，則系結列舉值的 Moniker，然後藉由呼叫 ISourcesRowset：：GetSourcesRowset 來擷取列舉值的資料列集 。

語法

HRESULT Open(LPMONIKER pMoniker) throw();

HRESULT Open(const CLSID* pClsid = & CLSID_OLEDB_ENUMERATOR) throw();

HRESULT Open(const CEnumerator& enumerator) throw();

參數

pMoniker
[in]列舉值的 Moniker 指標。

pClsid
[in]列舉值的 指標 CLSID 。

列舉程式
[in]列舉值的參考。

傳回值

標準 HRESULT。

另請參閱

DBViewer
OLE DB 消費者範本
OLE DB 消費者範本參考