IErrorLookup Interface

IID

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

IErrorLookup is used by OLE DB error objects to determine the values of the error message, source, Help file path, and context ID based on the return code and a provider-specific error number.

Documentation: IErrorLookup

Methods in VTable order

IUnknown Methods

Description

QueryInterface

Returns pointers to supported interfaces.

AddRef

Increments reference count.

Release

Decrements reference count.

IErrorLookup Methods

Description

GetErrorDescription

Returns the error message and source, based on the return code and the provider-specific error number.

GetHelpInfo

Returns the path of the Help file and the context ID of the topic that explains the error.

ReleaseErrors

Releases any dynamic error information associated with a dynamic error ID.

QueryInterface

FUNCTION IErrorLookup_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 IErrorLookup_QueryInterface (pthis, riid, ppvObj) TO HRESULT
  FUNCTION = HRESULT
 

END FUNCTION

AddRef

FUNCTION IErrorLookup_AddRef ( _

  BYVAL pthis AS DWORD PTR _

  ) AS DWORD
 

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

END FUNCTION

Release

FUNCTION IErrorLookup_Release ( _

  BYVAL pthis AS DWORD PTR _

  ) AS DWORD
 

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

END FUNCTION

GetErrorDescription

FUNCTION IErrorLookup_GetErrorDescription ( _

  BYVAL pthis AS DWORD PTR _

, BYVAL hError AS DWORD _

, BYVAL dwLookupID AS DWORD _

, BYREF pdispparams AS DISPPARAMS _

, BYVAL lcid AS DWORD _

, BYREF pbstrSource AS STRING _

, BYREF pbstrDescription AS STRING _

  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[3] USING IErrorLookup_GetErrorDescription (pthis, hError, dwLookupID, pdispparams, lcid, pbstrSource, pbstrDescription) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

GetHelpInfo

FUNCTION IErrorLookup_GetHelpInfo ( _

  BYVAL pthis AS DWORD PTR _

, BYVAL hError AS DWORD _

, BYVAL dwLookupID AS DWORD _

, BYREF pbstrHelpFile AS STRING _

, BYREF pdwHelpContext AS DWORD _

  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[4] USING IErrorLookup_GetHelpInfo (pthis, hError, dwLookupID, pbstrHelpFile, pdwHelpContext) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

ReleaseErrors

FUNCTION IErrorLookup_ReleaseErrors ( _

  BYVAL pthis AS DWORD PTR _

, BYVAL dwDynamicErrorID AS DWORD _

  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[5] USING IErrorLookup_ReleaseErrors (pthis, dwDynamicErrorID) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION