ImageScanner.ScanFilesToFolderAsync Método

Definição

Namespace:

Windows.Devices.Scanners

Inicia um trabalho de verificação com a origem da verificação especificada e grava uma ou várias imagens em um arquivo de várias páginas, como TIFF, XPS e PDF; ou um ou vários arquivos de página única, como DIB, PNG, JPG e TIFF para o local da pasta especificado. Retorna o progresso da verificação.

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

A origem da verificação de imagem.

storageFolder

StorageFolder

O local da pasta de destino do arquivo verificado.

Retornos

IAsyncOperationWithProgress<ImageScannerScanResult,UInt32>

Windows.Foundation.IAsyncOperationWithProgress<Windows.Devices.Scanners.ImageScannerScanResult,unsigned int>

IAsyncOperationWithProgress<ImageScannerScanResult,uint32_t>

A lista de arquivos de imagem digitalizados de ImageScannerScanResult e o progresso do trabalho de verificação wia do UInt32, que indica quantos arquivos foram transferidos para a pasta de destino.

Atributos

RemoteAsyncAttribute

Comentários

Os arquivos são nomeados usando nomes temporários, com uma extensão de arquivo padrão que depende do tipo de formato de arquivo.

Observação

No aplicativo UWP, quando esse método é invocado, o aplicativo deve estar visível e em execução em primeiro plano.

Quando o aplicativo cancela a chamada assíncrona, ele inicia uma solicitação de cancelamento do trabalho de verificação atual. Não há garantia de que, se o aplicativo cancelar a chamada assíncrona, o trabalho de verificação será cancelado. Se o cancelamento for cancelado, o verificador poderá parar por estes motivos:

• Leva alguns segundos até que o scanner pare de verificar.
• Ele só para quando fica sem papel (para uma aquisição de alimentador).
• Ele conclui a execução da cabeça da varredura até o final da cama e, em seguida, retorna totalmente a cabeça de varredura para seu local estacionado (para uma aquisição de flatbed).

Internamente, o cancelamento assíncrono sinalizará o trabalho de verificação do WIA 2.0 atual conforme cancelado de dentro do aplicativo. Se o dispositivo WIA fizer o próximo retorno de chamada para o serviço WIA, o cancelamento do trabalho poderá ou não ser comunicado com êxito ao driver WIA. Mas, mesmo que o driver WIA receba a solicitação de cancelamento de um de seus retornos de chamada, não há garantia de que o driver possa impedir com êxito a verificação do scanner, imediatamente ou após qualquer período previsível de tempo.

Aqui está a lista de códigos de erro HRESULT específicos do WIA, bem como códigos de erro COM HRESULT padrão que essa função retorna.

Observação

(a API chamará WinRTOriginateError e/ou OriginateErrorWithResourceString (todos os erros de WIA específicos terão descrições de erro localizáveis) para as HRESULTs de falha específica do 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

Há dois casos especiais:

• O HRESULT do WIA de S_FALSE será convertido em uma chamada assíncrona cancelada (AsyncStatus.Canceled).
• O WIA_ERROR_PAPER_EMPTY do WIA será convertido por essa API para um retorno bem-sucedido (AsyncStatus.Completed) com uma lista vazia de arquivos (IVectorView.Size definido como 0). Para evitar arquivos órfãos, esse método exclui todos os arquivos órfãos restantes usados para transferir imagens após a falha, antes que a falha ocorra. O método salvará os arquivos de transferência como arquivos temporários e os manterá até que o trabalho de verificação seja concluído. O aplicativo deve instruir o usuário a examinar novamente o documento.