Partager via

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

  • Article

Obtient des informations sur une bande dans un site de bande.

Syntaxe

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

Paramètres

[in] dwBandID

Type : DWORD

ID de l’objet de bande à interroger.

[out, optional] ppstb

Type : IDeskBand**

Adresse d’un pointeur d’interface IDeskBand qui, lorsque cette méthode retourne correctement, pointe vers l’objet IDeskBand qui représente la bande. Cette valeur peut être NULL.

[out, optional] pdwState

Type : DWORD*

Pointeur vers une valeur DWORD qui, lorsque cette méthode retourne correctement, reçoit l’état de l’objet band. Cet état est une combinaison de BSSF_VISIBLE, de BSSF_NOTITLE et de BSSF_UNDELETEABLE. Pour plus d’informations sur ces indicateurs, consultez BANDSITEINFO . Cette valeur peut être NULL si les informations d’état ne sont pas nécessaires.

[out] pszName

Type : LPWSTR

Pointeur vers une mémoire tampon de caractères Unicode cchName qui, lorsque cette méthode retourne correctement, reçoit le nom de l’objet de bande.

[in] cchName

Type : int

Taille de la mémoire tampon pszName , en caractères.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Spécifications

   
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête shobjidl_core.h (include Shldisp.h)
DLL Shell32.dll (version 4.71 ou ultérieure)