IRegisterProvider Interface

IID_IRegisterProvider

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

The root binder's IRegisterProvider interface manages the mapping of URL schemes and prefixes to OLE DB providers.

Documentation: IRegisterProvider

Methods in VTable order

IUnknown Methods

Description

QueryInterface

Returns pointers to supported interfaces.

AddRef

Increments reference count.

Release

Decrements reference count.

IRegisterProvider Methods

Description

GetURLMapping

Returns the CLSID of the provider binder object that is mapped to a particular URL scheme or scheme and prefix.

SetURLMapping

Registers the ability of a provider binder object to process a particular URL scheme or scheme and prefix.

UnregisterProvider

Unregisters one or more URL mappings for a provider.

QueryInterface

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

END FUNCTION

AddRef

FUNCTION IRegisterProvider_AddRef ( _

  BYVAL pthis AS DWORD PTR _

  ) AS DWORD
 

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

END FUNCTION

Release

FUNCTION IRegisterProvider_Release ( _

  BYVAL pthis AS DWORD PTR _

  ) AS DWORD
 

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

END FUNCTION

GetURLMapping

FUNCTION IRegisterProvider_GetURLMapping ( _
  BYVAL pthis AS DWORD PTR _

, BYVAL strURL AS STRING _

, BYVAL dwReserved AS DWORD _

, BYREF pclsidProvider AS GUID _

  ) AS LONG

  LOCAL HRESULT AS LONG
  strURL = UCODE$(strURL) & $NUL
  CALL DWORD @@pthis[3] USING IRegisterProvider_GetURLMapping (pthis, strURL, dwReserved, pclsidProvider) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

SetURLMapping

FUNCTION IRegisterProvider_SetURLMapping ( _
  BYVAL pthis AS DWORD PTR _

, BYVAL strURL AS STRING _

, BYVAL dwReserved AS DWORD _

, BYREF rclsidProvider AS GUID _

  ) AS LONG

  LOCAL HRESULT AS LONG
  strURL = UCODE$(strURL) & $NUL
  CALL DWORD @@pthis[4] USING IRegisterProvider_SetURLMapping (pthis, STRPTR(strURL), dwReserved, rclsidProvider) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

UnregisterProvider

FUNCTION IRegisterProvider_UnregisterProvider ( _
  BYVAL pthis AS DWORD PTR _

, BYVAL strURL AS STRING _

, BYVAL dwReserved AS DWORD _

, BYREF rclsidProvider AS GUID _

) AS LONG

  LOCAL HRESULT AS LONG
  strURL = UCODE$(strURL) & $NUL
  CALL DWORD @@pthis[5] USING IRegisterProvider_UnregisterProvider (pthis, strURL, dwReserved, rclsidProvider) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION