Método IWiaUIExtension2::GetDeviceIcon
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 |
|