Compartir a través de

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

  • Artículo

El método IconURL devuelve una dirección URL desde la que se puede cargar un icono del formato especificado.

Sintaxis

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

Parámetros

[in] bstrEncodingFormat

Especifica el tipo MIME del formato de codificación que se solicita para el icono.

[in] lSizeX

Especifica el ancho del icono, en píxeles. Los valores estándar son 16, 32 o 48.

[in] lSizeY

Especifica el alto del icono, en píxeles. Los valores estándar son 16, 32 o 48 píxeles.

[in] lBitDepth

Especifica la profundidad de bits del icono. Los valores estándar son 8, 16 o 24.

[out] pbstrIconURL

Recibe una referencia a una cadena que contiene la dirección URL desde la que se va a cargar el icono. Libere esta cadena con SysFreeString cuando ya no sea necesario.

Valor devuelto

Si el método se realiza correctamente, el valor devuelto se S_OK. De lo contrario, el método devuelve uno de los códigos de error COM definidos en WinError.h.

Comentarios

Una aplicación puede especificar cualquier valor para lSizeX, lSizeY y lBitDepth. Sin embargo, no hay ninguna garantía de que exista un icono con esas especificaciones.

Si no existe un icono coincidente, se devuelve la dirección URL del icono que coincide con el tamaño y la profundidad de bits especificada.

Requisitos

   
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible No se admite ninguno
Plataforma de destino Windows
Encabezado upnp.h
Archivo DLL Upnp.dll

Consulte también

IUPnPDevice