Méthode IUPnPDevice::IconURL (upnp.h)

Article
08/26/2023

La méthode IconURL retourne une URL à partir de laquelle une icône au format spécifié peut être chargée.

Syntaxe

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

Paramètres

[in] bstrEncodingFormat

Spécifie le type MIME du format d’encodage demandé pour l’icône.

[in] lSizeX

Spécifie la largeur de l’icône, en pixels. Les valeurs standard sont 16, 32 ou 48.

[in] lSizeY

Spécifie la hauteur de l’icône, en pixels. Les valeurs standard sont 16, 32 ou 48 pixels.

[in] lBitDepth

Spécifie la profondeur de bits de l’icône. Les valeurs standard sont 8, 16 ou 24.

[out] pbstrIconURL

Reçoit une référence à une chaîne qui contient l’URL à partir de laquelle l’icône doit être chargée. Relâchez cette chaîne avec SysFreeString lorsqu’elle n’est plus nécessaire.

Valeur retournée

Si la méthode réussit, la valeur de retour est S_OK. Sinon, la méthode retourne l’un des codes d’erreur COM définis dans WinError.h.

Remarques

Une application peut spécifier des valeurs pour lSizeX, lSizeY et lBitDepth. Toutefois, il n’existe aucune garantie qu’une icône existe avec ces spécifications.

S’il n’existe pas d’icône correspondante, l’URL de l’icône qui correspond le plus à la taille et à la profondeur de bits spécifiées est retournée.

Configuration requise


Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Aucun pris en charge
Plateforme cible	Windows
En-tête	upnp.h
DLL	Upnp.dll

Voir aussi

IUPnPDevice

Partager via