IErrorRecordsImpl 类

实现 OLE DB IErrorRecords 接口，向 CAtlArrayRecordClass 类型的数据成员 (m_rgErrors) 添加记录和从中检索记录。<>

语法

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

参数

T
派生自 IErrorRecordsImpl 的类。

RecordClass
一个表示 OLE DB 错误对象的类。

要求

标头: atldb.h

成员

方法

名称	描述
GetErrorDescriptionString	从错误记录中获取错误说明字符串。
GetErrorGUID	从错误记录中获取错误 GUID。
GetErrorHelpContext	从错误记录中获取帮助上下文 ID。
GetErrorHelpFile	从错误记录中获取帮助文件的完整路径名。
GetErrorSource	从错误记录中获取错误源代码。

接口方法

名称	描述
AddErrorRecord	将记录添加到 OLE DB 错误对象。
GetBasicErrorInfo	返回有关错误的基本信息，例如返回代码和特定于提供程序的错误号。
GetCustomErrorObject	返回指向自定义错误对象上的接口的指针。
GetErrorInfo	返回指定记录上的 IErrorInfo 接口指针。
GetErrorParameters	返回错误参数。
GetRecordCount	返回 OLE DB 记录对象中的记录数。

数据成员

名称	描述
m_rgErrors	错误记录数组。

IErrorRecordsImpl::GetErrorDescriptionString

从错误记录中获取错误说明字符串。

语法

LPOLESTR GetErrorDescriptionString(ERRORINFO& rCurError);

参数

rCurError
IErrorInfo 接口中的 ERRORINFO 记录。

返回值

指向描述错误的字符串的指针。

IErrorRecordsImpl::GetErrorGUID

从错误记录中获取错误 GUID。

语法

REFGUID GetErrorGUID(ERRORINFO& rCurError);

参数

rCurError
IErrorInfo 接口中的 ERRORINFO 记录。

返回值

对错误的 GUID 的引用。

IErrorRecordsImpl::GetErrorHelpContext

从错误记录中获取帮助上下文 ID。

语法

DWORD GetErrorHelpContext(ERRORINFO& rCurError);

参数

rCurError
IErrorInfo 接口中的 ERRORINFO 记录。

返回值

错误的帮助上下文 ID。

IErrorRecordsImpl::GetErrorHelpFile

从错误记录中获取帮助文件的路径名。

语法

LPOLESTR GetErrorHelpFile(ERRORINFO& rCurError);

参数

rCurError
IErrorInfo 接口中的 ERRORINFO 记录。

返回值

指向包含错误帮助文件路径名的字符串的指针。

IErrorRecordsImpl::GetErrorSource

从错误记录中获取导致错误的源代码。

语法

LPOLESTR GetErrorSource(ERRORINFO& rCurError);

参数

rCurError
IErrorInfo 接口中的 ERRORINFO 记录。

返回值

指向包含错误源代码的字符串的指针。

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;

另请参阅

OLE DB 提供程序模板
OLE DB 提供程序模板体系结构