CEnumerator 类

使用 OLE DB 枚举器对象,该对象公开 ISourcesRowset 接口以返回一个描述所有数据源和枚举器的行集合。

语法

class CEnumerator :
   public CAccessorRowset< CAccessor <CEnumeratorAccessor >>

要求

标头: atldbcli.h

成员

方法

名称 描述
查找 搜索可用的提供程序(数据源),查找一个具有指定名称的提供程序。
GetMoniker 检索当前记录的 IMoniker 接口。
打开 打开枚举器。

备注

可以从此类间接检索 ISourcesRowset 数据。

CEnumerator::Find

在可用提供程序之间查找指定名称。

语法

bool Find(TCHAR* szSearchName) throw();

参数

szSearchName
[in] 要搜索的名称。

返回值

如果找到名称,则为 true。 否则为 false

备注

此名称将映射到 ISourcesRowset 接口的 SOURCES_NAME 成员。

CEnumerator::GetMoniker

分析显示名称以提取可转换为名字对象字符串的组件。

语法

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

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

参数

ppMoniker
[out] 从当前行的显示名称 (CEnumeratorAccessor::m_szParseName) 分析的名字对象。

lpszDisplayName
[in] 要分析的显示名称。

返回值

标准 HRESULT。

CEnumerator::Open

如果指定了枚举器,则绑定枚举器的名字对象,然后通过调用 ISourcesRowset::GetSourcesRowset 来检索枚举器的行集。

语法

HRESULT Open(LPMONIKER pMoniker) throw();

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

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

参数

pMoniker
[in] 指向枚举器名字对象的指针。

pClsid
[in] 指向枚举器的 CLSID 的指针。

enumerator
[in] 对枚举器的引用。

返回值

标准 HRESULT。

另请参阅

DBViewer
OLE DB 使用者模板
OLE DB 使用者模板参考