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

Name	Beschreibung
GetErrorDescriptionString	Ruft die Fehlerbeschreibungszeichenfolge aus einem Fehlerdatensatz ab.
GetErrorGUID	Ruft die Fehler-GUID aus einem Fehlerdatensatz ab.
GetErrorHelpContext	Ruft die Hilfekontext-ID aus einem Fehlerdatensatz ab.
GetErrorHelpFile	Ruft den vollständigen Pfadnamen der Hilfedatei aus einem Fehlerdatensatz ab.
GetErrorSource	Ruft den Fehlerquellcode aus einem Fehlerdatensatz ab.

Schnittstellenmethoden

Name	Beschreibung
AddErrorRecord	Fügt dem OLE DB-Fehlerobjekt einen Datensatz hinzu.
GetBasicErrorInfo	Gibt grundlegende Informationen zum Fehler zurück, z. B. den Rückgabecode und die anbieterspezifische Fehlernummer.
GetCustomErrorObject	Gibt einen Zeiger auf eine Schnittstelle für ein benutzerdefiniertes Fehlerobjekt zurück.
GetErrorInfo	Gibt einen IErrorInfo-Schnittstellenzeiger für den angegebenen Datensatz zurück.
GetErrorParameters	Gibt die Fehlerparameter zurück.
GetRecordCount	Gibt die Anzahl der Datensätze im OLE DB-Datensatzobjekt zurück.

Datenelemente

Name	Beschreibung
m_rgErrors	Ein Array von Fehlerdatensätzen.

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