Método IUPnPDevice::IconURL (upnp.h)
O método IconURL retorna uma URL da qual um ícone do formato especificado pode ser carregado.
Sintaxe
HRESULT IconURL(
[in] BSTR bstrEncodingFormat,
[in] LONG lSizeX,
[in] LONG lSizeY,
[in] LONG lBitDepth,
[out] BSTR *pbstrIconURL
);
Parâmetros
[in] bstrEncodingFormat
Especifica o tipo MIME do formato de codificação solicitado para o ícone.
[in] lSizeX
Especifica a largura do ícone, em pixels. Os valores padrão são 16, 32 ou 48.
[in] lSizeY
Especifica a altura do ícone, em pixels. Os valores padrão são 16, 32 ou 48 pixels.
[in] lBitDepth
Especifica a profundidade do bit do ícone. Os valores padrão são 8, 16 ou 24.
[out] pbstrIconURL
Recebe uma referência a uma cadeia de caracteres que contém a URL da qual o ícone deve ser carregado. Solte essa cadeia de caracteres com SysFreeString quando ela não for mais necessária.
Valor retornado
Se o método for bem-sucedido, o valor retornado será S_OK. Caso contrário, o método retornará um dos códigos de erro COM definidos em WinError.h.
Comentários
Um aplicativo pode especificar quaisquer valores para lSizeX, lSizeY e lBitDepth. No entanto, não há garantia de que exista um ícone com essas especificações.
Se um ícone correspondente não existir, a URL do ícone que mais corresponde ao tamanho e à profundidade de bit especificada será retornada.
Requisitos
| Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Nenhum compatível |
| Plataforma de Destino | Windows |
| Cabeçalho | upnp.h |
| DLL | Upnp.dll |