CEnumerator-Klasse
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