ImageScanner.ScanFilesToFolderAsync Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Inicia un trabajo de examen con el origen de examen especificado y escribe una o varias imágenes en un archivo de varias páginas, como TIFF, XPS y PDF; o uno o varios archivos de página única, como DIB, PNG, JPG y TIFF en la ubicación de carpeta especificada. Devuelve el progreso del examen.
public:
virtual IAsyncOperationWithProgress<ImageScannerScanResult ^, unsigned int> ^ ScanFilesToFolderAsync(ImageScannerScanSource scanSource, StorageFolder ^ storageFolder) = ScanFilesToFolderAsync;/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<ImageScannerScanResult, uint32_t> ScanFilesToFolderAsync(ImageScannerScanSource const& scanSource, StorageFolder const& storageFolder);[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<ImageScannerScanResult,uint> ScanFilesToFolderAsync(ImageScannerScanSource scanSource, StorageFolder storageFolder);function scanFilesToFolderAsync(scanSource, storageFolder)Public Function ScanFilesToFolderAsync (scanSource As ImageScannerScanSource, storageFolder As StorageFolder) As IAsyncOperationWithProgress(Of ImageScannerScanResult, UInteger)Parámetros
- scanSource
- ImageScannerScanSource
Origen del examen de imágenes.
- storageFolder
- StorageFolder
Ubicación de la carpeta de destino del archivo examinado.
Devoluciones
Windows.Foundation.IAsyncOperationWithProgress<Windows.Devices.Scanners.ImageScannerScanResult,unsigned int>
IAsyncOperationWithProgress<ImageScannerScanResult,uint32_t>
La lista de archivos de imagen digitalizados de ImageScannerScanResult y el progreso del trabajo de examen de WIA desde UInt32, que indica cuántos archivos se transfirieron a la carpeta de destino.
- Atributos
Comentarios
Los archivos se denominan con nombres temporales, con una extensión de archivo estándar que depende del tipo de formato de archivo.
Nota
En la aplicación para UWP, cuando se invoca este método, la aplicación debe estar visible y en ejecución en primer plano.
Cuando la aplicación cancela la llamada asincrónica, inicia una solicitud de cancelación del trabajo de examen actual. No hay ninguna garantía de que si la aplicación cancela la llamada asincrónica que se cancelará el trabajo de examen. Si la cancelación pasa, el escáner puede detenerse por estos motivos:
- El escáner tarda unos segundos en detener el examen.
- Solo se detiene cuando se queda sin papel (para una adquisición de alimentador).
- Completa la ejecución de la cabeza del escaneo hasta el final de la cama y, a continuación, devuelve completamente el cabezal de exploración a su ubicación estacionada (para una adquisición de camas planas).
Internamente, la cancelación asincrónica marcará el trabajo de examen actual de WIA 2.0 como cancelado desde dentro de la aplicación. Si el dispositivo WIA realiza la siguiente devolución de llamada al servicio WIA, la cancelación del trabajo puede o no comunicarse correctamente con el controlador WIA. Sin embargo, incluso si el controlador WIA recibe la solicitud de cancelación de una de sus devoluciones de llamada, no hay ninguna garantía de que el controlador pueda detener correctamente el examen, inmediatamente o después de cualquier período de tiempo predecible.
Esta es la lista de códigos de error HRESULT específicos de WIA, así como códigos de error HRESULT COM estándar que devuelve esta función.
Nota
(la API llamará a WinRTOriginateError o OriginateErrorWithResourceString (todos los errores de WIA específicos tendrán descripciones de errores localizables) para los HRESULT de error específicos de WIA):
| WIA_ERROR_GENERAL_ERROR | WIA_ERROR_PAPER_JAM | WIA_ERROR_PAPER_EMPTY |
| WIA_ERROR_PAPER_PROBLEM | WIA_ERROR_OFFLINE | WIA_ERROR_BUSY |
| WIA_ERROR_WARMING_UP | WIA_ERROR_USER_INTERVENTION | WIA_ERROR_ITEM_DELETED |
| WIA_ERROR_DEVICE_COMMUNICATION | WIA_ERROR_INVALID_COMMAND | WIA_ERROR_INCORRECT_HARDWARE_SETTING |
| WIA_ERROR_DEVICE_LOCKED | WIA_ERROR_EXCEPTION_IN_DRIVER | WIA_ERROR_INVALID_DRIVER_RESPONSE |
| WIA_ERROR_COVER_OPEN | WIA_ERROR_LAMP_OFF | WIA_ERROR_MULTI_FEED |
Hay dos casos especiales:
- El HRESULT de WIA de S_FALSE se traducirá a una llamada asincrónica cancelada (AsyncStatus.Canceled).
- La WIA_ERROR_PAPER_EMPTY de WIA se traducirá mediante esta API a una devolución correcta (AsyncStatus.Completed) con una lista vacía de archivos (IVectorView.Size establecido en 0). Para evitar archivos huérfanos, este método elimina los archivos huérfanos restantes usados para transferir imágenes tras un error, antes de que se produjera el error. El método guardará los archivos de transferencia como archivos temporales y los mantendrá hasta que se complete el trabajo de examen. La aplicación debe indicar al usuario que vuelva a examinar el documento.