Compartilhar via

Classe CEnumerator

  • Artigo

Usa um objeto enumerador de OLE DB, que expõe a interface ISourcesRowset para retornar um conjunto de linhas que descreve todas as fontes de dados e enumeradores.

Sintaxe

class CEnumerator :
   public CAccessorRowset< CAccessor <CEnumeratorAccessor >>

Requisitos

Cabeçalho: atldbcli.h

Membros

Métodos

Nome Descrição
Localizar Pesquisa por provedores disponíveis (fontes de dados) procurando um com o nome especificado.
GetMoniker Recupera a interface IMoniker do registro atual.
Aberto Abre o enumerador.

Comentários

Você pode recuperar os dados de ISourcesRowset indiretamente dessa classe.

CEnumerator::Find

Procura um nome especificado entre os provedores disponíveis.

Sintaxe

bool Find(TCHAR* szSearchName) throw();

Parâmetros

szSearchName
[in] O nome a ser procurado.

Valor de retorno

true se o nome foi encontrado. Caso contrário, false.

Comentários

Esse nome é mapeado para o membro SOURCES_NAME da interface ISourcesRowset.

CEnumerator::GetMoniker

Analisa o nome de exibição para extrair o componente da cadeia de caracteres que pode ser convertido em um moniker.

Sintaxe

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

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

Parâmetros

ppMoniker
[out] O moniker analisado do nome de exibição (CEnumeratorAccessor::m_szParseName) da linha atual.

lpszDisplayName
[in] O nome de exibição a ser analisado.

Valor de retorno

Um valor HRESULT padrão.

CEnumerator::Open

Associa o moniker para o enumerador, se for especificado, então recupera o conjunto de linhas para o enumerador chamando ISourcesRowset::GetSourcesRowset.

Sintaxe

HRESULT Open(LPMONIKER pMoniker) throw();

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

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

Parâmetros

pMoniker
[in] Um ponteiro para um moniker para um enumerador.

pClsid
[in] Um ponteiro para um CLSID de um enumerador.

enumerator
[in] Uma referência a um enumerador.

Valor de retorno

Um valor HRESULT padrão.

Confira também

DBViewer
Modelos de consumidor OLE DB
Referência de modelos de consumidor do OLE DB