Compartir a través de


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

Obtiene información sobre una banda en un sitio de banda.

Sintaxis

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

Identificador del objeto de banda que se va a consultar.

[out, optional] ppstb

Tipo: IDeskBand**

Dirección de un puntero de interfaz IDeskBand que, cuando este método vuelve correctamente, apunta al objeto IDeskBand que representa la banda. Este valor puede ser NULL.

[out, optional] pdwState

Tipo: DWORD*

Puntero a un valor DWORD que, cuando este método devuelve correctamente, recibe el estado del objeto band. Este estado es una combinación de BSSF_VISIBLE, BSSF_NOTITLE y BSSF_UNDELETEABLE. Vea BANDSITEINFO para obtener más información sobre esas marcas. Este valor puede ser NULL si no se necesita la información de estado.

[out] pszName

Tipo: LPWSTR

Puntero a un búfer de caracteres Unicode cchName que, cuando este método devuelve correctamente, recibe el nombre del objeto band.

[in] cchName

Tipo: int

Tamaño del búfer pszName , en caracteres.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Requisitos

   
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shobjidl_core.h (incluya Shldisp.h)
Archivo DLL Shell32.dll (versión 4.71 o posterior)