CEnumerator-Klasse

  • Artikel

Verwendet ein OLE DB-Enumerationsobjekt, das die ISourcesRowset-Schnittstelle verfügbar macht, um ein Rowset zurückzugeben, das alle Datenquellen und Enumerationen beschreibt.

Syntax

class CEnumerator :
   public CAccessorRowset< CAccessor <CEnumeratorAccessor >>

Anforderungen

Header: atldbcli.h

Member

Methoden

Name Beschreibung
Suchen Durchsucht verfügbare Anbieter (Datenquellen), die nach einem Anbieter mit dem angegebenen Namen suchen.
GetMoniker Ruft die IMoniker Schnittstelle für den aktuellen Datensatz ab.
Öffnen Öffnet den Enumerator.

Hinweise

Sie können die ISourcesRowset Daten indirekt aus dieser Klasse abrufen.

CEnumerator::Find

Sucht unter den verfügbaren Anbietern nach einem angegebenen Namen.

Syntax

bool Find(TCHAR* szSearchName) throw();

Parameter

szSearchName
[in] Der Name, nach dem gesucht werden soll.

Rückgabewert

true wenn der Name gefunden wurde. Andernfalls false.

Hinweise

Dieser Name ist dem SOURCES_NAME Element der ISourcesRowset-Schnittstelle zugeordnet.

CEnumerator::GetMoniker

Analysiert den Anzeigenamen, um die Komponente der Zeichenfolge zu extrahieren, die in einen Moniker konvertiert werden kann.

Syntax

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

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

Parameter

ppMoniker
[out] Der Moniker wurde aus dem Anzeigenamen (CEnumeratorAccessor::m_szParseName) der aktuellen Zeile analysiert.

lpszDisplayName
[in] Der anzeigename, der analysiert werden soll.

Rückgabewert

Ein Standard-HRESULT.

CEnumerator::Open

Bindet den Moniker für den Enumerator, wenn eins angegeben ist, ruft dann das Rowset für die Enumeration ab, indem ISourcesRowset::GetSourcesRowset aufgerufen wird.

Syntax

HRESULT Open(LPMONIKER pMoniker) throw();

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

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

Parameter

pMoniker
[in] Ein Zeiger auf einen Moniker für einen Enumerator.

pClsid
[in] Ein Zeiger auf den CLSID Enumerator.

enumerator
[in] Ein Verweis auf einen Enumerator.

Rückgabewert

Ein Standard-HRESULT.

Siehe auch

DBViewer
OLE DB-Consumervorlagen
Referenz der OLE DB-Consumervorlagen