IErrorRecordsImpl — Klasa

Implementuje interfejs IErrorRecords OLE DB, dodając rekordy do i pobierając rekordy z elementu członkowskiego danych (m_rgErrors) typu CAtlArrayRecordClass<>.

Składnia

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

Parametry

T
Klasa pochodząca z IErrorRecordsImplklasy .

RecordClass
Klasa reprezentująca obiekt błędu OLE DB.

Wymagania

Nagłówek: atldb.h

Elementy członkowskie

Metody

Nazwa/nazwisko	opis
GetErrorDescriptionString	Pobiera ciąg opisu błędu z rekordu błędu.
GetErrorGUID	Pobiera identyfikator GUID błędu z rekordu błędu.
GetErrorHelpContext	Pobiera identyfikator kontekstu pomocy z rekordu błędu.
GetErrorHelpFile	Pobiera pełną nazwę ścieżki pliku pomocy z rekordu błędu.
GetErrorSource	Pobiera kod źródłowy błędu z rekordu błędu.

Metody interfejsu

Nazwa/nazwisko	opis
AddErrorRecord	Dodaje rekord do obiektu błędu OLE DB.
GetBasicErrorInfo	Zwraca podstawowe informacje o błędzie, takie jak kod powrotny i numer błędu specyficzny dla dostawcy.
GetCustomErrorObject	Zwraca wskaźnik do interfejsu w obiekcie błędu niestandardowego.
GetErrorInfo	Zwraca wskaźnik interfejsu IErrorInfo dla określonego rekordu.
GetErrorParameters	Zwraca parametry błędu.
GetRecordCount	Zwraca liczbę rekordów w obiekcie rekordu OLE DB.

Składowe danych

Nazwa/nazwisko	opis
m_rgErrors	Tablica rekordów błędów.

IErrorRecordsImpl::GetErrorDescriptionString

Pobiera ciąg opisu błędu z rekordu błędu.

Składnia

LPOLESTR GetErrorDescriptionString(ERRORINFO& rCurError);

Parametry

rCurError
ERRORINFO Rekord w interfejsieIErrorInfo.

Wartość zwracana

Wskaźnik do ciągu opisującego błąd.

IErrorRecordsImpl::GetErrorGUID

Pobiera identyfikator GUID błędu z rekordu błędu.

Składnia

REFGUID GetErrorGUID(ERRORINFO& rCurError);

Parametry

rCurError
ERRORINFO Rekord w interfejsieIErrorInfo.

Wartość zwracana

Odwołanie do identyfikatora GUID błędu.

IErrorRecordsImpl::GetErrorHelpContext

Pobiera identyfikator kontekstu pomocy z rekordu błędu.

Składnia

DWORD GetErrorHelpContext(ERRORINFO& rCurError);

Parametry

rCurError
ERRORINFO Rekord w interfejsieIErrorInfo.

Wartość zwracana

Identyfikator kontekstu pomocy dla błędu.

IErrorRecordsImpl::GetErrorHelpFile

Pobiera nazwę ścieżki pliku pomocy z rekordu błędu.

Składnia

LPOLESTR GetErrorHelpFile(ERRORINFO& rCurError);

Parametry

rCurError
ERRORINFO Rekord w interfejsieIErrorInfo.

Wartość zwracana

Wskaźnik do ciągu zawierającego nazwę ścieżki pliku pomocy dla błędu.

IErrorRecordsImpl::GetErrorSource

Pobiera kod źródłowy, który spowodował błąd z rekordu błędu.

Składnia

LPOLESTR GetErrorSource(ERRORINFO& rCurError);

Parametry

rCurError
ERRORINFO Rekord w interfejsieIErrorInfo.

Wartość zwracana

Wskaźnik do ciągu zawierającego kod źródłowy błędu.

IErrorRecordsImpl::AddErrorRecord

Dodaje rekord do obiektu błędu OLE DB.

Składnia

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

Parametry

Zobacz IErrorRecords::AddErrorRecord w dokumentacji programisty OLE DB.

IErrorRecordsImpl::GetBasicErrorInfo

Zwraca podstawowe informacje o błędzie, takie jak kod powrotny i numer błędu specyficzny dla dostawcy.

Składnia

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

Parametry

Zobacz IErrorRecords::GetBasicErrorInfo w dokumentacji programisty OLE DB.

IErrorRecordsImpl::GetCustomErrorObject

Zwraca wskaźnik do interfejsu w obiekcie błędu niestandardowego.

Składnia

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

Parametry

Zobacz IErrorRecords::GetCustomErrorObject w dokumentacji programisty OLE DB.

IErrorRecordsImpl::GetErrorInfo

Zwraca wskaźnik interfejsu IErrorInfo dla określonego rekordu.

Składnia

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

Parametry

Zobacz IErrorRecords::GetErrorInfo w dokumentacji programisty OLE DB.

IErrorRecordsImpl::GetErrorParameters

Zwraca parametry błędu.

Składnia

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

Parametry

Zobacz IErrorRecords::GetErrorParameters w dokumentacji programisty OLE DB.

IErrorRecordsImpl::GetRecordCount

Zwraca liczbę rekordów w obiekcie rekordu OLE DB.

Składnia

STDMETHOD(GetRecordCount )(ULONG *pcRecords);

Parametry

Zobacz IErrorRecords::GetRecordCount w dokumentacji programisty OLE DB.

IErrorRecordsImpl::m_rgErrors

Tablica rekordów błędów.

Składnia

CAtlArray< RecordClass > m_rgErrors;

Zobacz też

Szablony dostawców OLE DB
Architektura szablonu dostawcy OLE DB