IErrorRecords Interface

IID

{0C733A67-2A1C-11CE-ADE5-00AA0044773D}

IErrorRecords is defined by OLE DB. It is used to add and retrieve records in an OLE DB error object. Information is passed to and from OLE DB error objects in an ERRORINFO structure. For information about this structure, see "Error Records" in Chapter 16: Errors.
 

Documentation: IErrorRecords

Methods in VTable order

IUnknown Methods

Description

QueryInterface

Returns pointers to supported interfaces.

AddRef

Increments reference count.

Release

Decrements reference count.

IErrorRecords Methods

Description

AddErrorRecord

Adds a record to an OLE DB error object.

GetBasicErrorInfo

Returns basic information about the error, such as the return code and provider-specific error number.

GetCustomErrorObject

Returns a pointer to an interface on the custom error object.

GetErrorInfo

Returns an IErrorInfo interface pointer on the specified record.

GetErrorParameters

Returns the error parameters.

GetRecordCount

Returns the count of records in the OLE DB error object.

QueryInterface

FUNCTION IErrorRecords_QueryInterface ( _

  BYVAL pthis AS DWORD PTR _

, BYREF riid AS GUID _

, BYREF ppvObj AS DWORD _

  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[0] USING IErrorRecords_QueryInterface (pthis, riid, ppvObj) TO HRESULT
  FUNCTION = HRESULT
 

END FUNCTION

AddRef

FUNCTION IErrorRecords_AddRef ( _

  BYVAL pthis AS DWORD PTR _

  ) AS DWORD
 

  LOCAL DWRESULT AS LONG
  CALL DWORD @@pthis[1] USING IErrorRecords_AddRef (pthis) TO DWRESULT
  FUNCTION = DWRESULT
 

END FUNCTION

Release

FUNCTION IErrorRecords_Release ( _

  BYVAL pthis AS DWORD PTR _

  ) AS DWORD
 

  LOCAL DWRESULT AS DWORD
  CALL DWORD @@pthis[2] USING IErrorRecords_Release (pthis) TO DWRESULT
  FUNCTION = DWRESULT
 

END FUNCTION

AddErrorRecord

FUNCTION IErrorRecords_AddErrorRecord ( _

  BYVAL pthis AS DWORD PTR _

, BYVAL pErrorInfo AS DWORD _

, BYVAL dwLookupID AS DWORD _

, BYREF pdispparams AS DISPPARAMS _

, BYVAL punkCustomError AS DWORD _

, BYVAL dwDynamicErrorID AS DWORD _

  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[3] USING IErrorRecords_AddErrorRecord (pthis, pErrorInfo, dwLookupID, pdispparams, punkCustomError, dwDynamicErrorID) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

GetBasicErrorInfo

FUNCTION IErrorRecords_GetBasicErrorInfo ( _

  BYVAL pthis AS DWORD PTR _

, BYVAL ulRecordNum AS DWORD _

, BYREF pErrorInfo AS DWORD _

  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[4] USING IErrorRecords_GetBasicErrorInfo (pthis, ulRecordNum, pErrorInfo) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

GetCustomErrorObject

FUNCTION IErrorRecords_GetCustomErrorObject ( _

  BYVAL pthis AS DWORD PTR _

, BYVAL ulRecordNum AS DWORD _

, BYREF riid AS GUID _

, BYREF ppObject AS DWORD _

  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[5] USING IErrorRecords_GetCustomErrorObject (pthis, ulRecordNum, riid, ppObject) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

GetErrorInfo

FUNCTION IErrorRecords_GetErrorInfo ( _

  BYVAL pthis AS DWORD PTR _

, BYVAL ulRecordNum AS DWORD _

, BYVAL lcid AS DWORD _

, BYREF ppErrorInfo AS DWORD _

  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[6] USING IErrorRecords_GetErrorInfo (pthis, ulRecordNum, lcid, ppErrorInfo) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

GetErrorParameters

FUNCTION IErrorRecords_GetErrorParameters ( _

  BYVAL pthis AS DWORD PTR _

, BYVAL ulRecordNum AS DWORD _

, BYREF pdispparams AS DISPPARAMS _

  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[7] USING IErrorRecords_GetErrorParameters (pthis, ulRecordNum, pdispparams) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

GetRecordCount

FUNCTION IErrorRecords_GetRecordCount ( _

  BYVAL pthis AS DWORD PTR _

, BYREF pRecords AS DWORD _

  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[7] USING IErrorRecords_GetRecordCount (pthis, pRecords) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION