CDBErrorInfo Sınıfı

OLE DB IErrorRecords arabirimini kullanarak OLE DB hata işleme desteği sağlar.

Sözdizimi

class CDBErrorInfo

Gereksinimler

Üst bilgi: atldbcli.h

Üyeler

Yöntemler

Veri Akışı Adı	Açıklama
GetAllErrorInfo	Bir hata kaydında yer alan tüm hata bilgilerini döndürür.
GetBasicErrorInfo	Belirtilen hatayla ilgili temel bilgileri döndürmek için IErrorRecords::GetBasicErrorInfo öğesini çağırır.
GetCustomErrorObject	Özel bir hata nesnesinde arabirim işaretçisi döndürmek için IErrorRecords::GetCustomErrorObject öğesini çağırır.
GetErrorInfo	Belirtilen kayda arabirim IErrorInfo işaretçisi döndürmek için IErrorRecords::GetErrorInfo öğesini çağırır.
GetErrorParameters	Hata parametrelerini döndürmek için IErrorRecords::GetErrorParameters'ı çağırır.
GetErrorRecords	Belirtilen nesne için hata kayıtlarını alır.

Açıklamalar

Bu arabirim kullanıcıya bir veya daha fazla hata kaydı döndürür. Hata kayıtlarının sayısını almak için önce CDBErrorInfo::GetErrorRecords çağrısı yapın. Ardından her kayıtla ilgili hata bilgilerini almak için CDBErrorInfo::GetAllErrorInfo gibi erişim işlevlerinden birini çağırın.

CDBErrorInfo::GetAllErrorInfo

Bir hata kaydında yer alan tüm hata bilgisi türlerini döndürür.

Sözdizimi

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

Parametreler

ulRecordNum
[in] Hata bilgilerinin döndürüleceği kaydın sıfır tabanlı sayısı.

lcid
[in] Döndürülecek hata bilgilerinin yerel ayar kimliği.

pbstrDescription
[out] Hatanın metin açıklamasının işaretçisi veya yerel ayar desteklenmiyorsa NULL. Bkz. Açıklamalar.

pbstrSource
[out] Hatayı oluşturan bileşenin adını içeren bir dize işaretçisi.

pguid
[out] Hatayı tanımlayan arabirimin GUID'sine ilişkin bir işaretçi.

pdwHelpContext
[out] Hatanın yardım bağlam kimliğinin işaretçisi.

pbstrHelpFile
[out] Hatayı açıklayan yardım dosyasının yolunu içeren bir dize işaretçisi.

Dönüş Değeri

Başarılı olursa S_OK. Diğer dönüş değerleri için OLE DB Programcı Başvurusu'nda IErrorRecords::GetErrorInfo bölümüne bakın.

Açıklamalar

PbstrDescription'ın çıkış değeri, yerel ayar desteklenmiyorsa veya aşağıdaki koşulların ikisi de doğruysa değeri NULL olarak ayarlayan çağrısıyla IErrorInfo::GetDescriptiondahili olarak elde edilir:

1. lcid değeri ABD İngilizcesi DEĞİlDİr ve

2. lcid değeri GetUserDefaultLCID tarafından döndürülen değere EŞIT DEĞİlDİr.

CDBErrorInfo::GetBasicErrorInfo

Dönüş kodu ve sağlayıcıya özgü hata numarası gibi hatayla ilgili temel bilgileri döndürmek için IErrorRecords::GetBasicErrorInfo öğesini çağırır.

Sözdizimi

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

Parametreler

OLE DB Programcı Başvurusunda IErrorRecords::GetBasicErrorInfo bölümüne bakın.

Dönüş Değeri

Standart bir HRESULT.

CDBErrorInfo::GetCustomErrorObject

Özel bir hata nesnesinde arabirim işaretçisi döndürmek için IErrorRecords::GetCustomErrorObject öğesini çağırır.

Sözdizimi

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

Parametreler

OLE DB Programcı Başvurusu'nda IErrorRecords::GetCustomErrorObject bölümüne bakın.

Dönüş Değeri

Standart bir HRESULT.

CDBErrorInfo::GetErrorInfo

Belirtilen kayda bir IErrorInfo arabirim işaretçisi döndürmek için IErrorRecords::GetErrorInfo çağırır.

Sözdizimi

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

Parametreler

OLE DB Programcı Başvurusu'nda IErrorRecords::GetErrorInfo bölümüne bakın.

Dönüş Değeri

Standart bir HRESULT.

CDBErrorInfo::GetErrorParameters

Hata parametrelerini döndürmek için IErrorRecords::GetErrorParameters'ı çağırır.

Sözdizimi

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

Parametreler

OLE DB Programcı Başvurusunda IErrorRecords::GetErrorParameters bölümüne bakın.

Dönüş Değeri

Standart bir HRESULT.

CDBErrorInfo::GetErrorRecords

Belirtilen nesne için hata kayıtlarını alır.

Sözdizimi

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

HRESULT GetErrorRecords(ULONG* pcRecords) throw();

Parametreler

Punk
[in] Hata kayıtlarının alındığı nesnenin arabirimi.

iid
[in] Hatayla ilişkili arabirimin IID değeri.

pcRecords
[out] Hata kayıtlarının (tek tabanlı) sayısına yönelik bir işaretçi.

Dönüş Değeri

Standart bir HRESULT.

Açıklamalar

Hata bilgilerini hangi arabirimden alabileceğinizi denetlemek istiyorsanız işlevin ilk biçimini kullanın. Aksi takdirde, ikinci formu kullanın.

Ayrıca bkz.

DBViewer
OLE DB Tüketici Şablonları
OLE DB Tüketici Şablonları Başvurusu