Compartilhar via

Método IBandSite::QueryBand (shobjidl_core.h)

  • Artigo

Obtém informações sobre uma banda em um site de banda.

Sintaxe

HRESULT QueryBand(
  [in]            DWORD     dwBandID,
  [out, optional] IDeskBand **ppstb,
  [out, optional] DWORD     *pdwState,
  [out]           LPWSTR    pszName,
  [in]            int       cchName
);

Parâmetros

[in] dwBandID

Tipo: DWORD

A ID do objeto de banda a ser consultado.

[out, optional] ppstb

Tipo: IDeskBand**

Endereço de um ponteiro de interface IDeskBand que, quando esse método retorna com êxito, aponta para o objeto IDeskBand que representa a banda. Esse valor pode ser NULL.

[out, optional] pdwState

Tipo: DWORD*

Ponteiro para um valor DWORD que, quando esse método retorna com êxito, recebe o estado do objeto de banda. Esse estado é uma combinação de BSSF_VISIBLE, BSSF_NOTITLE e BSSF_UNDELETEABLE. Consulte BANDSITEINFO para obter mais informações sobre esses sinalizadores. Esse valor poderá ser NULL se as informações de estado não forem necessárias.

[out] pszName

Tipo: LPWSTR

Ponteiro para um buffer de caracteres Unicode cchName que, quando esse método retorna com êxito, recebe o nome do objeto de banda.

[in] cchName

Tipo: int

O tamanho do buffer pszName , em caracteres.

Valor retornado

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shobjidl_core.h (inclua Shldisp.h)
DLL Shell32.dll (versão 4.71 ou posterior)