CDBErrorInfo — Klasa

Zapewnia obsługę przetwarzania błędów OLE DB przy użyciu interfejsu IErrorRecords OLE DB.

Składnia

class CDBErrorInfo

Wymagania

Nagłówek: atldbcli.h

Elementy członkowskie

Metody

Uwagi

Ten interfejs zwraca użytkownikowi co najmniej jeden rekord błędu. Najpierw wywołaj element CDBErrorInfo::GetErrorRecords , aby uzyskać liczbę rekordów błędów. Następnie wywołaj jedną z funkcji dostępu, takich jak CDBErrorInfo::GetAllErrorInfo, aby pobrać informacje o błędzie dla każdego rekordu.

CDBErrorInfo::GetAllErrorInfo

Zwraca wszystkie typy informacji o błędach zawartych w rekordzie błędu.

Składnia

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

Parametry

ulRecordNum
[in] Liczba zerowa rekordu, dla którego mają być zwracane informacje o błędzie.

lcid
[in] Identyfikator ustawień regionalnych dla informacji o błędzie, które mają zostać zwrócone.

pbstrDescription
[out] Wskaźnik do tekstowego opisu błędu lub wartości NULL, jeśli ustawienia regionalne nie są obsługiwane. Zobacz uwagi.

pbstrSource
[out] Wskaźnik do ciągu zawierającego nazwę składnika, który wygenerował błąd.

pguid
[out] Wskaźnik do identyfikatora GUID interfejsu, który zdefiniował błąd.

pdwHelpContext
[out] Wskaźnik do identyfikatora kontekstu pomocy dla błędu.

pbstrHelpFile
[out] Wskaźnik do ciągu zawierającego ścieżkę do pliku pomocy, który opisuje błąd.

Wartość zwracana

S_OK, jeśli się powiedzie. Zobacz IErrorRecords::GetErrorInfo w dokumentacji programisty OLE DB, aby uzyskać inne wartości zwracane.

Uwagi

Wartość wyjściowa pbstrDescription jest uzyskiwana wewnętrznie przez wywołanie metody IErrorInfo::GetDescription, która ustawia wartość null, jeśli ustawienia regionalne nie są obsługiwane, lub jeśli oba następujące warunki są spełnione:

1. wartość lcid to NOT US English i

2. wartość lcid nie jest równa wartości zwracanej przez GetUserDefaultLCID.

CDBErrorInfo::GetBasicErrorInfo

Wywołuje metodę IErrorRecords::GetBasicErrorInfo , aby zwrócić podstawowe informacje o błędzie, takie jak kod powrotny i numer błędu specyficzny dla dostawcy.

Składnia

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

Parametry

Zobacz IErrorRecords::GetBasicErrorInfo w dokumentacji programisty OLE DB.

Wartość zwracana

Standardowy HRESULT.

CDBErrorInfo::GetCustomErrorObject

Wywołuje metodę IErrorRecords::GetCustomErrorObject , aby zwrócić wskaźnik do interfejsu w obiekcie błędu niestandardowego.

Składnia

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

Parametry

Zobacz IErrorRecords::GetCustomErrorObject w dokumentacji programisty OLE DB.

Wartość zwracana

Standardowy HRESULT.

CDBErrorInfo::GetErrorInfo

Wywołuje wskaźnik interfejsu IErrorRecords::GetErrorInfo, aby zwrócić wskaźnik interfejsu IErrorInfo do określonego rekordu.

Składnia

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

Parametry

Zobacz IErrorRecords::GetErrorInfo w dokumentacji programisty OLE DB.

Wartość zwracana

Standardowy HRESULT.

CDBErrorInfo::GetErrorParameters

Wywołuje parametry IErrorRecords::GetErrorParameters , aby zwrócić parametry błędu.

Składnia

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

Parametry

Zobacz IErrorRecords::GetErrorParameters w dokumentacji programisty OLE DB.

Wartość zwracana

Standardowy HRESULT.

CDBErrorInfo::GetErrorRecords

Pobiera rekordy błędów dla określonego obiektu.

Składnia

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

HRESULT GetErrorRecords(ULONG* pcRecords) throw();

Parametry

Punk
[in] Interfejs do obiektu, dla którego mają być wyświetlane rekordy błędów.

identyfikator iid
[in] Identyfikator IID interfejsu skojarzonego z błędem.

pcRecords
[out] Wskaźnik do (opartej na jednej) liczbie rekordów błędów.

Wartość zwracana

Standardowy HRESULT.

Uwagi

Użyj pierwszej formy funkcji, jeśli chcesz sprawdzić, z którego interfejsu mają zostać wyświetlone informacje o błędzie. W przeciwnym razie użyj drugiego formularza.

Zobacz też

DbViewer
Szablony konsumentów OLE DB
Szablony konsumentów OLE DB — dokumentacja