IBandSite Interface

IID_IBandSite

{4CF504B0-DE96-11D0-8B3F-00A0C911E8E5}

IBandSite is used to host band objects, such as IDeskBand.

Methods in VTable order

IUnknown Methods

Description

QueryInterface

Returns pointers to supported interfaces.

AddRef

Increments reference count.

Release

Decrements reference count.

IBandSite Method

Description

AddBand

Adds a band to a band site object.

EnumBands

Called to enumerate the bands in a band site.

QueryBand

Gets information about a band in a band site.

SetBandState

Set the state of a band in the band site.

RemoveBand

Removes a band from the band site.

GetBandObject

Gets a specified band object from a band site.

SetBandSiteInfo

Sets information about the band site.

GetBandSiteInfo

Gets information about a band in the band site.

AddBand

FUNCTION IBandSite_AddBand ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL punk AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[3] USING IBandSite_AddBand (pthis, punk) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

EnumBands

FUNCTION IBandSite_EnumBands ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL uBand AS DWORD _
, BYREF pdwBandID AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[4] USING IBandSite_EnumBands (pthis, uBand, pdwBandID) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

QueryBand

FUNCTION Proto_IBandSite_QueryBand ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL dwBandID AS DWORD _
, BYREF ppstb AS DWORD _
, BYREF pdwState AS DWORD _
, BYVAL pszName AS DWORD _
, BYVAL cchName AS DWORD _
  ) AS LONG
 

FUNCTION IBandSite_QueryBand ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL dwBandID AS DWORD _
, BYREF ppstb AS DWORD _
, BYREF pdwState AS DWORD _
, BYREF strName AS STRING _
  ) AS LONG

  strName = ""

  LOCAL HRESULT AS LONG

  LOCAL bstrLen AS LONG
  LOCAL pszName AS ASCIIZ * (%MAX_PATH * 2 - 1)
  CALL DWORD @@pthis[5] USING Proto_IBandSite_QueryBand (pthis, dwBandID, ppstb, pdwState, VARPTR(pszName), SIZEOF(pszName)) TO HRESULT
  IF HRESULT = %S_OK THEN
     bstrLen = lstrlenW(pszName)
     IF bstrlen THEN strName = ACODE$(PEEK$(VARPTR(pszName), bstrlen * 2))
  END IF

  FUNCTION = HRESULT

END FUNCTION

SetBandState

FUNCTION IBandSite_SetBandState ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL dwBandID AS DWORD _
, BYVAL dwMask AS DWORD _
, BYVAL dwState AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[6] USING IBandSite_SetBandState (pthis, dwBandID, dwMask, dwState) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

RemoveBand

FUNCTION IBandSite_RemoveBand ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL dwBandID AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[7] USING IBandSite_RemoveBand (pthis, dwBandID) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

GetBandObject

FUNCTION IBandSite_GetBandObject ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL dwBandID AS DWORD _
, BYREF riid AS GUID _
, BYREF ppv AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[8] USING IBandSite_GetBandObject (pthis, dwBandID, riid, ppv) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

SetBandSiteInfo

FUNCTION IBandSite_SetBandSiteInfo ( _
  BYVAL pthis AS DWORD PTR _
, BYREF pbsinfo AS BANDSITEINFO _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[9] USING IBandSite_SetBandSiteInfo (pthis, pbsinfo) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

GetBandSiteInfo

FUNCTION IBandSite_GetBandSiteInfo ( _
  BYVAL pthis AS DWORD PTR _
, BYREF pbsinfo AS BANDSITEINFO _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[10] USING IBandSite_GetBandSiteInfo (pthis, pbsinfo) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION