Compartir a través de

IWiaUIExtension2::GetDeviceIcon (método)

  • Artículo

Obtiene un icono de dispositivo personalizado.

Sintaxis

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

Parámetros

bstrDeviceId [in]

Tipo: BSTR

Especifica el identificador de dispositivo del dispositivo WIA para el que se va a obtener el icono.

phIcon [out]

Tipo: HICON*

Apunta a una ubicación de memoria que recibirá un identificador para el icono del dispositivo.

nSize [in]

Tipo: ULONG

Especifica el tamaño de icono deseado, en píxeles. Se supone que el icono es cuadrado y nSize especifica el ancho y el alto del icono solicitado.

Valor devuelto

Tipo: HRESULT

Si el método se realiza correctamente, devuelve S_OK. Si se produce un error en el método, devuelve un código de error adecuado. En la tabla siguiente se muestran algunos de los posibles códigos de estado de retorno.

Código de error Descripción
E_INVALIDARG El parámetro bstrDeviceId o phIcon es NULL o bstrDeviceId no apunta a una cadena de identificador de dispositivo WIA válida.
E_FAIL No hay ningún recurso de icono disponible.
E_NOTIMPL No hay ningún icono del tamaño solicitado disponible.

 

Requisitos

Requisito Value
Cliente mínimo compatible
 Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible
 Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado
Wiadevd.h