ICreateRow Interface

IID_ICreateRow

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

ICreateRow creates and binds to an object named by a URL.

ICreateRow is a mandatory interface on the OLE DB root binder object and on all provider binder objects. It is also an optional interface on session and row objects.

Documentation: ICreateRow

Methods in VTable order

IUnknown Methods

Description

QueryInterface

Returns pointers to supported interfaces.

AddRef

Increments reference count.

Release

Decrements reference count.

ICreateRow Method

Description

CreateRow

Creates and binds to an object named by a URL and returns the requested interface pointer.

CanConvert

DECLARE FUNCTION Proto_ICreateRow_CreateRow ( _
  BYVAL pthis AS DWORD PTR _

, BYVAL pUnkOuter AS DWORD _

, BYVAL pwszURL AS DWORD _
, BYVAL dwBindURLFlags AS DWORD _

, BYREF rguid AS GUID _

, BYREF riid AS GUID _

, BYVAL pAuthenticate AS DWORD _

, BYREF pImplSession AS DBIMPLICITSESSION _

, BYREF pdwBindStatus AS DWORD _

, BYREF ppwszNewURL AS DWORD _

, BYREF ppUnk AS DWORD _

  ) AS LONG

FUNCTION ICreateRow_CreateRow ( _
  BYVAL pthis AS DWORD PTR _

, BYVAL pUnkOuter AS DWORD _

, BYVAL strURL AS STRING _
, BYVAL dwBindURLFlags AS DWORD _

, BYREF rguid AS GUID _

, BYREF riid AS GUID _

, BYVAL pAuthenticate AS DWORD _

, BYREF pImplSession AS DBIMPLICITSESSION _

, BYREF pdwBindStatus AS DWORD _

, BYREF strNewURL AS STRING _

, BYREF ppUnk AS DWORD _

  ) AS LONG

  strNewURL = ""
  LOCAL HRESULT AS LONG
  LOCAL bstrlen AS LONG
  LOCAL ppwszNewURL AS DWORD
  strURL = UCODE$(strURL) & $NUL
  CALL DWORD @@pthis[3] USING Proto_ICreateRow_CreateRow (pthis, pUnkOuter, STRPTR(strURL), dwBindURLFlags, rguid, riid, pAuthenticate, pImplSession, pdwBindStatus, ppwszNewURL, ppUnk) TO HRESULT
  IF ISTRUE ppwszNewURL THEN
     bstrlen = lstrlenW(BYVAL ppwszNewURL)
     IF ISTRUE bstrlen THEN
        strNewURL = PEEK$(ppwszNewURL, bstrlen * 2)
        strNewURL = ACODE$(strNewURL)
     END IF
     CoTaskMemFree ppwszNewURL
  END IF
  FUNCTION = HRESULT

END FUNCTION