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) |