CDBErrorInfo-Klasse

Bietet Unterstützung für die OLE DB-Fehlerverarbeitung mithilfe der OLE DB IErrorRecords-Schnittstelle .

Syntax

class CDBErrorInfo

Anforderungen

Header: atldbcli.h

Member

Methoden

Hinweise

Diese Schnittstelle gibt einen oder mehrere Fehlereinträge für den Benutzer zurück. Rufen Sie ZUERST CDBErrorInfo::GetErrorRecords auf, um eine Anzahl von Fehlerdatensätzen abzurufen. Rufen Sie dann eine der Zugriffsfunktionen auf, z . B. CDBErrorInfo::GetAllErrorInfo, um Fehlerinformationen für jeden Datensatz abzurufen.

CDBErrorInfo::GetAllErrorInfo

Gibt alle Typen von Fehlerinformationen zurück, die in einem Fehlerdatensatz enthalten sind.

Syntax

HRESULT GetAllErrorInfo(ULONG ulRecordNum,
   LCID lcid,  BSTR* pbstrDescription,
   BSTR* pbstrSource = NULL,
   GUID* pguid = NULL,
   DWORD* pdwHelpContext = NULL,
   BSTR* pbstrHelpFile = NULL) const throw();

Parameter

ulRecordNum
[in] Die nullbasierte Nummer des Datensatzes, für den Fehlerinformationen zurückgegeben werden sollen.

lcid
[in] Die Gebietsschema-ID für die Fehlerinformationen, die zurückgegeben werden sollen.

pbstrDescription
[out] Ein Zeiger auf eine Textbeschreibung des Fehlers oder NULL, wenn das Gebietsschema nicht unterstützt wird. Siehe Hinweise.

pbstrSource
[out] Ein Zeiger auf eine Zeichenfolge mit dem Namen der Komponente, die den Fehler generiert hat.

pguid
[out] Ein Zeiger auf die GUID der Schnittstelle, die den Fehler definiert hat.

pdwHelpContext
[out] Ein Zeiger auf die Hilfekontext-ID für den Fehler.

pbstrHelpFile
[out] Ein Zeiger auf eine Zeichenfolge, die den Pfad zur Hilfedatei enthält, die den Fehler beschreibt.

Rückgabewert

S_OK, wenn dies erfolgreich ist. Weitere Rückgabewerte finden Sie unter "IErrorRecords::GetErrorInfo " in der OLE DB-Programmierreferenz .

Hinweise

Der Ausgabewert von pbstrDescription wird intern durch Aufrufen IErrorInfo::GetDescriptionabgerufen, wodurch der Wert auf NULL festgelegt wird, wenn das Gebietsschema nicht unterstützt wird oder beide der folgenden Bedingungen erfüllt sind:

1. der Wert von lcid ist NICHT US-Englisch und

2. der Wert von lcid ist NICHT gleich dem wert, der von GetUserDefaultLCID zurückgegeben wird.

CDBErrorInfo::GetBasicErrorInfo

Ruft IErrorRecords::GetBasicErrorInfo auf, um grundlegende Informationen zum Fehler zurückzugeben, z. B. den Rückgabecode und die anbieterspezifische Fehlernummer.

Syntax

HRESULT GetBasicErrorInfo(ULONG ulRecordNum,
   ERRORINFO* pErrorInfo) const throw();

Parameter

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

Rückgabewert

Ein Standard-HRESULT.

CDBErrorInfo::GetCustomErrorObject

Ruft IErrorRecords::GetCustomErrorObject auf, um einen Zeiger auf eine Schnittstelle für ein benutzerdefiniertes Fehlerobjekt zurückzugeben.

Syntax

HRESULT GetCustomErrorObject(ULONG ulRecordNum,
   REFIID riid,IUnknown** ppObject) const throw();

Parameter

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

Rückgabewert

Ein Standard-HRESULT.

CDBErrorInfo::GetErrorInfo

Ruft IErrorRecords::GetErrorInfo auf, um einen IErrorInfo-Schnittstellenzeiger auf den angegebenen Datensatz zurückzugeben.

Syntax

HRESULT GetErrorInfo(ULONG ulRecordNum,
   LCID lcid,IErrorInfo** ppErrorInfo) const throw();

Parameter

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

Rückgabewert

Ein Standard-HRESULT.

CDBErrorInfo::GetErrorParameters

Ruft IErrorRecords::GetErrorParameters auf, um die Fehlerparameter zurückzugeben.

Syntax

HRESULT GetErrorParameters(ULONG ulRecordNum,
   DISPPARAMS* pdispparams) const throw();

Parameter

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

Rückgabewert

Ein Standard-HRESULT.

CDBErrorInfo::GetErrorRecords

Ruft Fehlerdatensätze für das angegebene Objekt ab.

Syntax

HRESULT GetErrorRecords(IUnknown* pUnk,
   const IID& iid,
   ULONG* pcRecords) throw();

HRESULT GetErrorRecords(ULONG* pcRecords) throw();

Parameter

Punk
[in] Schnittstelle zum Objekt, für das Fehlerdatensätze abgerufen werden sollen.

iid
[in] Die IID der Schnittstelle, die dem Fehler zugeordnet ist.

pcRecords
[out] Ein Zeiger auf die (1-basierte) Anzahl von Fehlerdatensätzen.

Rückgabewert

Ein Standard-HRESULT.

Hinweise

Verwenden Sie das erste Formular der Funktion, wenn Sie überprüfen möchten, von welcher Schnittstelle die Fehlerinformationen abgerufen werden sollen. Verwenden Sie andernfalls das zweite Formular.

Siehe auch

DBViewer
OLE DB-Consumervorlagen
Referenz der OLE DB-Consumervorlagen