IUPnPDevice：：IconURL 方法 (upnp.h)

IconURL 方法返回可从中加载指定格式图标的 URL。

语法

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

[in] bstrEncodingFormat

指定为图标请求的编码格式的 MIME 类型。

[in] lSizeX

指定图标的宽度（以像素为单位）。标准值为 16、32 或 48。

[in] lSizeY

指定图标的高度（以像素为单位）。标准值为 16、32 或 48 像素。

[in] lBitDepth

指定图标的位深度。标准值为 8、16 或 24。

[out] pbstrIconURL

接收对字符串的引用，该字符串包含要从中加载图标的 URL。当不再需要时，使用 SysFreeString 释放此字符串。

如果方法成功，则返回值S_OK。否则，方法将返回 WinError.h 中定义的 COM 错误代码之一。

应用程序可以为 lSizeX、 lSizeY 和 lBitDepth 指定任何值。但是，不能保证存在具有这些规范的图标。

如果匹配图标不存在，则返回与指定的大小和位深度最匹配的图标的 URL。