Класс 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
.
Замечания
Это имя сопоставляется с SOURCES_NAME
членом интерфейса ISourcesRowset .
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