Поделиться через


Класс 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