IBandHost::CreateBand method

Creates a specified band.

Syntax


HRESULT CreateBand(
  [in]  REFCLSID rclsidBand,
  [in]  BOOL     fAvailable,
  [in]  BOOL     fVisible,
  [in]  REFIID   riid,
  [out] void     **ppv
);

Parameters

rclsidBand [in]

Type: REFCLSID

A reference to a CLSID. Used to ensure a duplicate band is not created.

fAvailable [in]

Type: BOOL

Specifies band availability.

fVisible [in]

Type: BOOL

Specifies band visibility.

riid [in]

Type: REFIID

A reference to a desired IID.

ppv [out]

Type: void**

Contains the address of a pointer to a band specified by riid.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Shobjidl.h

IDL

Shobjidl.idl

 

 

Show: