IBandSite::SetBandState method (shobjidl_core.h)

Set the state of a band in the band site.

Syntax

HRESULT SetBandState(
  [in] DWORD dwBandID,
  [in] DWORD dwMask,
  [in] DWORD dwState
);

Parameters

[in] dwBandID

Type: DWORD

The ID of the band to set. If this parameter is -1, then set the state of all bands in the band site.

[in] dwMask

Type: DWORD

The mask of the states to set.

[in] dwState

Type: DWORD

The state values to be set. These are combinations of BSSF_* flags. For more information, see BANDSITEINFO.

Return value

Type: HRESULT

Returns S_OK if successful, or a COM-defined error code otherwise.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header shobjidl_core.h (include Shldisp.h)
DLL Shell32.dll (version 4.71 or later)

See also

BANDSITEINFO

IBandSite

IDeskBand