IErrorRecordsImpl-Klasse

Implementiert die OLE DB IErrorRecords-Schnittstelle, das Hinzufügen und Abrufen von Datensätzen aus einem Datenmememm (m_rgErrors) vom Typ CAtlArray<RecordClass>.

Syntax

template <class T, class RecordClass = ATLERRORINFO>
class IErrorRecordsImpl : public IErrorRecords

Parameter

T
Eine von IErrorRecordsImpl.

RecordClass
Eine Klasse, die ein OLE DB-Fehlerobjekt darstellt.

Anforderungen

Header: „atldb.h“

Member

Methoden

Schnittstellenmethoden

Datenelemente

IErrorRecordsImpl::GetErrorDescriptionString

Ruft die Fehlerbeschreibungszeichenfolge aus einem Fehlerdatensatz ab.

Syntax

LPOLESTR GetErrorDescriptionString(ERRORINFO& rCurError);

Parameter

rCurError
Ein ERRORINFO Datensatz in einer IErrorInfo Schnittstelle.

Rückgabewert

Ein Zeiger auf eine Zeichenfolge, die den Fehler beschreibt.

IErrorRecordsImpl::GetErrorGUID

Ruft die Fehler-GUID aus einem Fehlerdatensatz ab.

Syntax

REFGUID GetErrorGUID(ERRORINFO& rCurError);

Parameter

rCurError
Ein ERRORINFO Datensatz in einer IErrorInfo Schnittstelle.

Rückgabewert

Ein Verweis auf eine GUID für den Fehler.

IErrorRecordsImpl::GetErrorHelpContext

Ruft die Hilfekontext-ID aus einem Fehlerdatensatz ab.

Syntax

DWORD GetErrorHelpContext(ERRORINFO& rCurError);

Parameter

rCurError
Ein ERRORINFO Datensatz in einer IErrorInfo Schnittstelle.

Rückgabewert

Die Hilfekontext-ID für den Fehler.

IErrorRecordsImpl::GetErrorHelpFile

Ruft den Pfadnamen der Hilfedatei aus einem Fehlerdatensatz ab.

Syntax

LPOLESTR GetErrorHelpFile(ERRORINFO& rCurError);

Parameter

rCurError
Ein ERRORINFO Datensatz in einer IErrorInfo Schnittstelle.

Rückgabewert

Zeigen Sie auf eine Zeichenfolge, die den Pfadnamen der Hilfedatei für den Fehler enthält.

IErrorRecordsImpl::GetErrorSource

Ruft den Quellcode ab, der den Fehler aus einem Fehlerdatensatz verursacht hat.

Syntax

LPOLESTR GetErrorSource(ERRORINFO& rCurError);

Parameter

rCurError
Ein ERRORINFO Datensatz in einer IErrorInfo Schnittstelle.

Rückgabewert

Zeigen Sie auf eine Zeichenfolge, die den Quellcode für den Fehler enthält.

IErrorRecordsImpl::AddErrorRecord

Fügt dem OLE DB-Fehlerobjekt einen Datensatz hinzu.

Syntax

STDMETHOD(AddErrorRecord )(ERRORINFO *pErrorInfo,
   DWORD dwLookupID,
   DISPPARAMS *pdispparams,
   IUnknown *punkCustomError,
   DWORD dwDynamicErrorID);

Parameter

Siehe "IErrorRecords::AddErrorRecord " in der OLE DB-Programmierreferenz.

IErrorRecordsImpl::GetBasicErrorInfo

Gibt grundlegende Informationen zum Fehler zurück, z. B. den Rückgabecode und die anbieterspezifische Fehlernummer.

Syntax

STDMETHOD(GetBasicErrorInfo )(ULONG ulRecordNum,
   ERRORINFO *pErrorInfo);

Parameter

Siehe "IErrorRecords::GetBasicErrorInfo " in der OLE DB-Programmierreferenz.

IErrorRecordsImpl::GetCustomErrorObject

Gibt einen Zeiger auf eine Schnittstelle für ein benutzerdefiniertes Fehlerobjekt zurück.

Syntax

STDMETHOD(GetCustomErrorObject )(ULONG ulRecordNum,
   REFIID riid,
   IUnknown **ppObject);

Parameter

Siehe "IErrorRecords::GetCustomErrorObject " in der OLE DB-Programmierreferenz.

IErrorRecordsImpl::GetErrorInfo

Gibt einen IErrorInfo-Schnittstellenzeiger für den angegebenen Datensatz zurück.

Syntax

STDMETHOD(GetErrorInfo )(ULONG ulRecordNum,
   LCID lcid,
   IErrorInfo **ppErrorInfo);

Parameter

Siehe "IErrorRecords::GetErrorInfo " in der OLE DB-Programmierreferenz.

IErrorRecordsImpl::GetErrorParameters

Gibt die Fehlerparameter zurück.

Syntax

STDMETHOD(GetErrorParameters )(ULONG ulRecordNum,
   DISPPARAMS *pdispparams);

Parameter

Siehe "IErrorRecords::GetErrorParameters " in der OLE DB-Programmierreferenz.

IErrorRecordsImpl::GetRecordCount

Gibt die Anzahl der Datensätze im OLE DB-Datensatzobjekt zurück.

Syntax

STDMETHOD(GetRecordCount )(ULONG *pcRecords);

Parameter

Siehe "IErrorRecords::GetRecordCount " in der OLE DB-Programmierreferenz.

IErrorRecordsImpl::m_rgErrors

Ein Array von Fehlerdatensätzen.

Syntax

CAtlArray< RecordClass > m_rgErrors;

Siehe auch

OLE DB-Anbietervorlagen
Architektur von OLE DB-Anbietervorlagen