Condividi tramite

Metodo IBandSite::QueryBand (shobjidl_core.h)

  • Articolo

Ottiene informazioni su una band in un sito band.

Sintassi

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

Parametri

[in] dwBandID

Tipo: DWORD

ID dell'oggetto band da eseguire in query.

[out, optional] ppstb

Tipo: IDeskBand**

Indirizzo di un puntatore dell'interfaccia IDeskBand che, quando questo metodo restituisce correttamente, punta all'oggetto IDeskBand che rappresenta la banda. Questo valore può essere NULL.

[out, optional] pdwState

Tipo: DWORD*

Puntatore a un valore DWORD che, quando questo metodo restituisce correttamente, riceve lo stato dell'oggetto band. Questo stato è una combinazione di BSSF_VISIBLE, BSSF_NOTITLE e BSSF_UNDELETEABLE. Per altre informazioni su tali flag, vedere BANDSITEINFO . Questo valore può essere NULL se le informazioni sullo stato non sono necessarie.

[out] pszName

Tipo: LPWSTR

Puntatore a un buffer di caratteri Unicode cchName che, quando questo metodo restituisce correttamente, riceve il nome dell'oggetto band.

[in] cchName

Tipo: int

Dimensioni del buffer pszName , in caratteri.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Requisiti

   
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione shobjidl_core.h (includere Shldisp.h)
DLL Shell32.dll (versione 4.71 o successiva)