實作 OLE DB IErrorRecords 介面，在 CAtlArrayRecordClass>< 類型的數據成員 （m_rgErrors） 中新增和擷取記錄。
語法
template <class T, class RecordClass = ATLERRORINFO>
class IErrorRecordsImpl : public IErrorRecords
參數
T
衍生自 IErrorRecordsImpl的類別。
RecordClass
表示 OLE DB 錯誤對象的類別。
需求
Header: atldb.h
成員
方法
| 名稱 | 描述 |
|---|---|
| GetErrorDescriptionString | 從錯誤記錄取得錯誤描述字串。 |
| GetErrorGUID | 從錯誤記錄取得錯誤 GUID。 |
| GetErrorHelpContext | 從錯誤記錄取得說明內容識別碼。 |
| GetErrorHelpFile | 從錯誤記錄取得說明檔的完整路徑名稱。 |
| GetErrorSource | 從錯誤記錄取得錯誤原始程式碼。 |
介面方法
| 名稱 | 描述 |
|---|---|
| AddErrorRecord | 將記錄加入至 OLE DB 錯誤物件。 |
| GetBasicErrorInfo | 傳回錯誤的基本資訊，例如傳回碼和提供者特定的錯誤號碼。 |
| GetCustomErrorObject | 傳回自定義錯誤物件上介面的指標。 |
| GetErrorInfo | 傳 回指定記錄上的 IErrorInfo 介面指標。 |
| GetErrorParameters | 傳回錯誤參數。 |
| GetRecordCount | 會傳回 OLE DB 記錄物件中的記錄數目。 |
資料成員
| 名稱 | 描述 |
|---|---|
| m_rgErrors | 錯誤記錄的陣列。 |
IErrorRecordsImpl::GetErrorDescriptionString
從錯誤記錄取得錯誤描述字串。
語法
LPOLESTR GetErrorDescriptionString(ERRORINFO& rCurError);
參數
rCurError
ERRORINFO介面中的IErrorInfo記錄。
傳回值
描述錯誤的字串指標。
IErrorRecordsImpl::GetErrorGUID
從錯誤記錄取得錯誤 GUID。
語法
REFGUID GetErrorGUID(ERRORINFO& rCurError);
參數
rCurError
ERRORINFO介面中的IErrorInfo記錄。
傳回值
錯誤的 GUID 參考。
IErrorRecordsImpl::GetErrorHelpContext
從錯誤記錄取得說明內容識別碼。
語法
DWORD GetErrorHelpContext(ERRORINFO& rCurError);
參數
rCurError
ERRORINFO介面中的IErrorInfo記錄。
傳回值
錯誤的說明內容識別碼。
IErrorRecordsImpl::GetErrorHelpFile
從錯誤記錄取得說明檔的路徑名稱。
語法
LPOLESTR GetErrorHelpFile(ERRORINFO& rCurError);
參數
rCurError
ERRORINFO介面中的IErrorInfo記錄。
傳回值
字串的指標，其中包含錯誤說明檔的路徑名稱。
IErrorRecordsImpl::GetErrorSource
取得從錯誤記錄中造成錯誤的原始程式碼。
語法
LPOLESTR GetErrorSource(ERRORINFO& rCurError);
參數
rCurError
ERRORINFO介面中的IErrorInfo記錄。
傳回值
字串的指標，其中包含錯誤的原始程式碼。
IErrorRecordsImpl::AddErrorRecord
將記錄加入至 OLE DB 錯誤物件。
語法
STDMETHOD(AddErrorRecord )(ERRORINFO *pErrorInfo,
DWORD dwLookupID,
DISPPARAMS *pdispparams,
IUnknown *punkCustomError,
DWORD dwDynamicErrorID);
參數
請參閱 OLE DB 程式設計人員參考中的 IErrorRecords：：AddErrorRecord。
IErrorRecordsImpl::GetBasicErrorInfo
傳回錯誤的基本資訊，例如傳回碼和提供者特定的錯誤號碼。
語法
STDMETHOD(GetBasicErrorInfo )(ULONG ulRecordNum,
ERRORINFO *pErrorInfo);
參數
請參閱 OLE DB 程式設計人員參考中的 IErrorRecords：：GetBasicErrorInfo。
IErrorRecordsImpl::GetCustomErrorObject
傳回自定義錯誤物件上介面的指標。
語法
STDMETHOD(GetCustomErrorObject )(ULONG ulRecordNum,
REFIID riid,
IUnknown **ppObject);
參數
請參閱 OLE DB 程式設計人員參考中的 IErrorRecords：：GetCustomErrorObject。
IErrorRecordsImpl::GetErrorInfo
傳 回指定記錄上的 IErrorInfo 介面指標。
語法
STDMETHOD(GetErrorInfo )(ULONG ulRecordNum,
LCID lcid,
IErrorInfo **ppErrorInfo);
參數
請參閱 OLE DB 程式設計人員參考中的 IErrorRecords：：GetErrorInfo。
IErrorRecordsImpl::GetErrorParameters
傳回錯誤參數。
語法
STDMETHOD(GetErrorParameters )(ULONG ulRecordNum,
DISPPARAMS *pdispparams);
參數
請參閱 OLE DB 程式設計人員參考中的 IErrorRecords：：GetErrorParameters。
IErrorRecordsImpl::GetRecordCount
會傳回 OLE DB 記錄物件中的記錄數目。
語法
STDMETHOD(GetRecordCount )(ULONG *pcRecords);
參數
請參閱 OLE DB 程式設計人員參考中的 IErrorRecords：：GetRecordCount。
IErrorRecordsImpl::m_rgErrors
錯誤記錄的陣列。
語法
CAtlArray< RecordClass > m_rgErrors;