Metode IUPnPDevice::IconURL (upnp.h)

Artikel
08/26/2023

Metode IconURL mengembalikan URL tempat ikon format yang ditentukan dapat dimuat.

Sintaks

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

Parameter

[in] bstrEncodingFormat

Menentukan jenis MIME dari format pengodean yang diminta untuk ikon tersebut.

[in] lSizeX

Menentukan lebar ikon, dalam piksel. Nilai standar adalah 16, 32, atau 48.

[in] lSizeY

Menentukan tinggi ikon, dalam piksel. Nilai standar adalah 16, 32, atau 48 piksel.

[in] lBitDepth

Menentukan kedalaman bit ikon. Nilai standar adalah 8, 16, atau 24.

[out] pbstrIconURL

Menerima referensi ke string yang berisi URL tempat ikon akan dimuat. Rilis string ini dengan SysFreeString saat tidak lagi diperlukan.

Nilai kembali

Jika metode berhasil, nilai yang dikembalikan adalah S_OK. Jika tidak, metode mengembalikan salah satu kode kesalahan COM yang ditentukan dalam WinError.h.

Keterangan

Aplikasi dapat menentukan nilai apa pun untuk lSizeX, lSizeY, dan lBitDepth. Namun, tidak ada jaminan bahwa ikon ada dengan spesifikasi tersebut.

Jika ikon yang cocok tidak ada, URL untuk ikon yang paling cocok dengan ukuran dan kedalaman bit yang ditentukan dikembalikan.

Persyaratan


Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Tidak ada yang didukung
Target Platform	Windows
Header	upnp.h
DLL	Upnp.dll

Lihat juga

IUPnPDevice

Bagikan melalui