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이 반환됩니다.