IWiaDevMgr2::GetImageDlg (método)

El método IWiaDevMgr2::GetImageDlg muestra uno o varios cuadros de diálogo que permiten a un usuario adquirir una imagen de un dispositivo Windows Image Acquisition (WIA) 2.0 y escribir la imagen en un archivo especificado. Este método amplía la funcionalidad de IWiaDevMgr2::SelectDeviceDlg para encapsular la adquisición de imágenes en una sola llamada API.

Sintaxis

HRESULT GetImageDlg(
  [in]      LONG      lFlags,
  [in]      BSTR      bstrDeviceID,
  [in]      HWND      hwndParent,
  [in]      BSTR      bstrFolderName,
  [in]      BSTR      bstrFilename,
  [in]      LONG      *plNumFiles,
  [in]      BSTR      **ppbstrFilePaths,
  [in, out] IWiaItem2 **ppItem
);

Parámetros

lFlags [in]

Tipo: LONG

Especifica el comportamiento del cuadro de diálogo. Se puede establecer en los valores siguientes:

Marca	Significado
0	Comportamiento predeterminado.
WIA_DEVICE_DIALOG_USE_COMMON_UI	Use la interfaz de usuario del sistema en lugar de la interfaz de usuario proporcionada por el proveedor. Si la interfaz de usuario del sistema no está disponible, se usa la interfaz de usuario del proveedor. Si ninguna interfaz de usuario está disponible, la función devuelve E_NOTIMPL.

 

bstrDeviceID [in]

Tipo: BSTR

Especifica el analizador que se va a usar.

hwndParent [in]

Tipo: HWND

Identificador de la ventana que posee el cuadro de diálogo Obtener imagen .

bstrFolderName [in]

Tipo: BSTR

Especifica el nombre de la carpeta en la que se almacenan los archivos examinados.

bstrFilename [in]

Tipo: BSTR

Especifica el nombre del archivo en el que se van a escribir los datos de la imagen.

plNumFiles [in]

Tipo: LONG*

Puntero al número de archivos que se van a examinar.

ppbstrFilePaths [in]

Tipo: BSTR**

Dirección de un puntero a una matriz de rutas de acceso para los archivos examinados. Inicialice el puntero para que apunte a una matriz de tamaño cero (0) antes de llamar a IWiaDevMgr2::GetImageDlg . Vea Comentarios.

ppItem [in, out]

Tipo: IWiaItem2**

Dirección de un puntero al IWiaItem2 desde el que se examinaron las imágenes.

Valor devuelto

Tipo: HRESULT

IWiaDevMgr2::GetImageDlg devuelve S_OK si los datos se transfieren correctamente, devuelve S_FALSE si el usuario cancela el cuadro de diálogo o devuelve un error COM estándar.

Nota

El parámetro ppbstrFilePaths no está necesariamente vacío, si la función devuelve S_FALSE. Si el usuario cancela, las páginas que han completado el examen se procesan y devuelven en ppbstrFilePaths. Incluso si no se usan, debe liberar la matriz. Vea Comentarios.

 

Observaciones

Si la aplicación pasa NULL para el valor del parámetro bstrDeviceID , IWiaDevMgr2::GetImageDlg muestra el cuadro de diálogo Seleccionar dispositivo para que el usuario pueda seleccionar el dispositivo de entrada WIA 2.0.

Use un elemento de menú denominado From scanner (Desde escáner ) en el menú Archivo para que las selecciones de dispositivo e imagen estén disponibles en la aplicación.

Llame a SysFreeString en cada BSTR de la matriz a la que apunta ppbstrFilePaths[i] y llame a CoTaskMemFree en la propia matriz para liberar memoria asociada. Si se devuelve S_FALSE, compruebe si el valor que plNumFiles apunta a no es cero. Si el valor no es cero, libere los recursos ppbstrFilePaths[i] de la aplicación, ya que el usuario podría cancelar después de examinar una o varias páginas. Inicialice plNumFiles en cero antes de llamar a IWiaDevMgr2::GetImageDlg. Si plNumFiles no se inicializa en cero y un error en la infraestructura COM hace que la función devuelva S_FALSE antes de llamar a IWiaDevMgr2::GetImageDlg , plNumFiles tendrá un valor de elementos no utilizados engañoso.

El cuadro de diálogo debe tener derechos suficientes para bstrFolderName para que pueda guardar los archivos con nombres de archivo únicos. Proteja la carpeta con una lista de control de acceso (ACL) porque contiene datos de usuario.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado	Wia.h