IDBInfo Interface

IID_IDBInfo

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

IDBInfo returns information about the keywords and literals a provider supports. It is an optional interface on the data source objects.

Documentation: IDBInfo

Methods in VTable order

IUnknown Methods

Description

QueryInterface

Returns pointers to supported interfaces.

AddRef

Increments reference count.

Release

Decrements reference count.

IDBInfo Methods

Description

GetKeywords

Returns a list of provider-specific keywords.

GetLiteralInfo

Returns information about literals used in text commands and in ITableDefinition and IIndexDefinition.

GetKeywords

DECLARE FUNCTION Proto_IDBinfo_GetKeywords ( _
  BYVAL pthis AS DWORD PTR _

, BYREF ppwszKeywords AS DWORD _

  ) AS LONG

FUNCTION IDBinfo_GetKeywords ( _
  BYVAL pthis AS DWORD PTR _

, BYREF strKeywords AS STRING _

) AS LONG

  strKeywords = ""
  LOCAL HRESULT AS LONG
  LOCAL bstrlen AS LONG
  LOCAL ppwszKeywords AS DWORD
  CALL DWORD @@pthis[3] USING Proto_IDBinfo_GetKeywords (pthis, ppwszKeywords) TO HRESULT
  IF ISTRUE ppwszKeywords THEN
     bstrlen = lstrlenW(BYVAL ppwszKeywords)
     IF ISTRUE bstrlen THEN
        strKeywords = PEEK$(ppwszKeywords, bstrlen * 2)
        strKeywords = ACODE$(strKeywords)
     END IF
     CoTaskMemFree ppwszKeywords
  END IF
  FUNCTION = HRESULT

END FUNCTION

GetLiteralInfo

FUNCTION IDBinfo_GetLiteralInfo ( _
  BYVAL pthis AS DWORD PTR _

, BYVAL cLiterals AS DWORD _

, BYVAL rgLiterals AS DWORD _

, BYREF pcLiteralInfo AS DWORD _

, BYREF prgLiteralInfo AS DWORD _

, BYREF ppCharBuffer AS DWORD _

  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[4] USING IDBinfo_GetLiteralInfo (pthis, cLiterals, rgLiterals, pcLiteralInfo, prgLiteralInfo, ppCharBuffer) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION