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。