Método IWiaUIExtension2::GetDeviceIcon

Artigo
06/13/2023

Obtém um ícone de dispositivo personalizado.

Sintaxe

HRESULT GetDeviceIcon(
  [in]  BSTR  bstrDeviceId,
  [out] HICON *phIcon,
  [in]  ULONG nSize
);

Parâmetros

bstrDeviceId [in]

Tipo: BSTR

Especifica a ID do dispositivo WIA para o qual o ícone deve ser obtido.

phIcon [out]

Tipo: HICON*

Aponta para um local de memória que receberá um identificador para o ícone do dispositivo.

nSize [in]

Tipo: ULONG

Especifica o tamanho do ícone desejado, em pixels. O ícone é considerado quadrado e nSize especifica a largura e a altura do ícone solicitado.

Valor retornado

Tipo: HRESULT

Se o método for bem-sucedido, retornará S_OK. Se o método falhar, ele retornará um código de erro apropriado. A tabela a seguir mostra alguns dos possíveis códigos de status de retorno.

Código do erro	Descrição
E_INVALIDARG	O parâmetro bstrDeviceId ou phIcon é NULL ou bstrDeviceId não aponta para uma cadeia de caracteres de ID de dispositivo WIA válida
E_FAIL	Nenhum recurso de ícone está disponível.
E_NOTIMPL	Nenhum ícone do tamanho solicitado está disponível.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho	Wiadevd.h