Metodo IUPnPDevice::IconURL (upnp.h)

Il metodo IconURL restituisce un URL da cui è possibile caricare un'icona del formato specificato.

Sintassi

HRESULT IconURL(
  [in]  BSTR bstrEncodingFormat,
  [in]  LONG lSizeX,
  [in]  LONG lSizeY,
  [in]  LONG lBitDepth,
  [out] BSTR *pbstrIconURL
);

Parametri

[in] bstrEncodingFormat

Specifica il tipo MIME del formato di codifica richiesto per l'icona.

[in] lSizeX

Specifica la larghezza dell'icona, in pixel. I valori standard sono 16, 32 o 48.

[in] lSizeY

Specifica l'altezza dell'icona, in pixel. I valori standard sono 16, 32 o 48 pixel.

[in] lBitDepth

Specifica la profondità di bit dell'icona. I valori standard sono 8, 16 o 24.

[out] pbstrIconURL

Riceve un riferimento a una stringa contenente l'URL da cui caricare l'icona. Rilasciare questa stringa con SysFreeString quando non è più necessaria.

Valore restituito

Se il metodo ha esito positivo, il valore restituito viene S_OK. In caso contrario, il metodo restituisce uno dei codici di errore COM definiti in WinError.h.

Commenti

Un'applicazione può specificare qualsiasi valore per lSizeX, lSizeY e lBitDepth. Tuttavia, non esiste alcuna garanzia che esista un'icona con tali specifiche.

Se non esiste un'icona corrispondente, viene restituito l'URL dell'icona che corrisponde maggiormente alle dimensioni e alla profondità di bit specificata.

Requisiti

Vedi anche

IUPnPDevice