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。