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。