IScopedOperations Interface

IID_IScopedOperations

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

The IScopedOperations interface supports recursive operations on a tree-structured namespace, such as a file system, that is bound to an OLE DB row object. The scope of the row object is defined by the tree or subtree whose root node is bound to the row object. Each node in the tree can be bound to its own row object. One of the columns in each row object can be a rowset containing a row for each child of the node that is bound to the row object. The entire tree can thus be bound by a structure of row and rowset objects.

Documentation: IScopedOperations

Methods in VTable order

IUnknown Methods

Description

QueryInterface

Returns pointers to supported interfaces.

AddRef

Increments reference count.

Release

Decrements reference count.

IBindResource Method

Description

Bind

Binds to an object named by a URL.

IScopedOperations Method

Description

Copy

Copies trees or subtrees from source URLs to destination URLs.

Move

Moves trees or subtrees from source URLs to destination URLs.

Delete

Deletes trees or subtrees specified by URLs.

OpenRowset

Opens a rowset containing the child rows of the current row or of a URL-named row within the scope of the current row. Due to interface and method factoring, IScopedOperations::OpenRowset is not inherited from IOpenRowset. However, it is the very same method, adapted for direct binding within the scope of the current row.

QueryInterface

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

END FUNCTION

AddRef

FUNCTION IScopedOperations_AddRef ( _

  BYVAL pthis AS DWORD PTR _

  ) AS DWORD
 

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

END FUNCTION

Release

FUNCTION IScopedOperations_Release ( _

  BYVAL pthis AS DWORD PTR _

  ) AS DWORD
 

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

END FUNCTION

Bind

FUNCTION IScopedOperations_Bind ( _
  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 DWORD _

, BYREF pdwBindStatus AS DWORD _

, BYREF ppunk AS DWORD _

  ) AS LONG

  LOCAL HRESULT AS LONG

  strURL = UCODE$(strURL) & $NUL
  CALL DWORD @@pthis[3] USING IScopedOpreations_Bind (pthis, pUnkOuter, strURL, dwBindURLFlags, rguid, riid, pAuthenticate, pImplSession, pdwBindStatus, ppunk) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

Copy

FUNCTION IScopedOperations_Copy ( _
  BYVAL pthis AS DWORD PTR _

, BYVAL cRows AS DWORD _

, BYVAL rgpwszSourceURLs AS DWORD _

, BYVAL rgpwszDestURLs AS DWORD _

, BYVAL dwCopyFlags AS DWORD _

, BYVAL pAuthenticate AS DWORD _

, BYREF rgdwStatus AS DWORD _

, BYREF rgpwszNewURLs AS DWORD _

, BYREF ppStringsBuffer AS DWORD _

  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[4] USING IScopedOperations_Copy (pthis, cRows, rgpwszSourceURLs, rgpwszDestURLs, dwCopyFlags, pAuthenticate, rgdwStatus, rgpwszNewURLs, ppStringsBuffer) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

Move

FUNCTION IScopedOperations_Move ( _
  BYVAL pthis AS DWORD PTR _

, BYVAL cRows AS DWORD _

, BYVAL rgpwszSourceURLs AS DWORD _

, BYVAL rgpwszDestURLs AS DWORD _

, BYVAL dwMoveFlags AS DWORD _

, BYVAL pAuthenticate AS DWORD _

, BYREF rgdwStatus AS DWORD _

, BYREF rgpwszNewURLs AS DWORD _

, BYREF ppStringsBuffer AS DWORD _

  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[5] USING IScopedOperations_Move (pthis, cRows, rgpwszSourceURLs, rgpwszDestURLs, dwMoveFlags, pAuthenticate, rgdwStatus, rgpwszNewURLs, ppStringsBuffer) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

Delete

FUNCTION IScopedOperations_Delete ( _
  BYVAL pthis AS DWORD PTR _

, BYVAL cRows AS DWORD _

, BYVAL rgpwszURLs AS DWORD _

, BYVAL dwDeleteFlags AS DWORD _

, BYREF rgdwStatus AS DWORD _

  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[6] USING IScopedOperations_Delete (pthis, cRows, rgpwszURLs, dwDeleteFlags, rgdwStatus) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

OpenRowset

FUNCTION IScopedOperations_OpenRowset ( _
  BYVAL pthis AS DWORD PTR _

, BYVAL pUnkOuter AS DWORD _

, BYREF pTableID AS DBID _

, BYREF pIndexID AS DBID _

, BYREF riid AS GUID _

, BYVAL cPropertySets AS DWORD _

, BYREF rgPropertySets AS DWORD _

, BYREF ppRowset AS DWORD _

  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[7] USING IScopedOperations_OpenRowset (pthis, pUnkOuter, pTableID, pIndexID, riid, cPropertySets, rgPropertySets, ppRowset) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION