ImageScanner.ScanFilesToFolderAsync 메서드

정의

네임스페이스:

Windows.Devices.Scanners

지정된 검사 원본으로 스캔 작업을 시작하고 TIFF, XPS 및 PDF와 같은 하나의 다중 페이지 파일에 하나 이상의 이미지를 씁니다. 또는 DIB, PNG, JPG 및 TIFF와 같은 하나 이상의 단일 페이지 파일을 지정한 폴더 위치에 연결합니다. 검사 진행률을 반환합니다.

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)

매개 변수

scanSource

ImageScannerScanSource

이미지 검사 원본입니다.

storageFolder

StorageFolder

스캔한 파일의 대상 폴더 위치입니다.

반환

IAsyncOperationWithProgress<ImageScannerScanResult,UInt32>

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

IAsyncOperationWithProgress<ImageScannerScanResult,uint32_t>

ImageScannerScanResult에서 스캔한 이미지 파일 목록 및 UInt32의 WIA 스캔 작업 진행률입니다. 이는 대상 폴더로 전송된 파일 수를 나타냅니다.

특성

RemoteAsyncAttribute

설명

파일 이름은 임시 이름을 사용하며 파일 형식 형식에 따라 표준 파일 확장명을 사용합니다.

참고

UWP 앱에서 이 메서드가 호출되면 앱이 포그라운드에 표시되고 실행되어야 합니다.

앱이 비동기 호출을 취소하면 현재 검사 작업의 취소 요청을 시작합니다. 앱이 비동기 호출을 취소하는 경우 스캔 작업이 취소된다는 보장은 없습니다. 취소가 진행되는 경우 스캐너는 다음과 같은 이유로 중지할 수 있습니다.

• 스캐너가 검사를 중지하기까지 몇 초 정도 걸립니다.
• 용지가 부족할 때만 중지됩니다(피더 획득의 경우).
• 스캔 헤드를 침대 끝까지 실행한 다음 스캔 헤드를 주차된 위치(플랫베드 획득용)로 완전히 반환합니다.

내부적으로 비동기 취소는 앱 내에서 취소된 현재 WIA 2.0 검사 작업에 플래그를 지정합니다. WIA 디바이스가 WIA 서비스에 대한 다음 콜백을 수행하면 작업 취소가 WIA 드라이버에 성공적으로 전달되거나 전달되지 않을 수 있습니다. 그러나 WIA 드라이버가 콜백 중 하나에서 취소 요청을 수신하더라도 드라이버가 예측 가능한 기간의 즉시 또는 이후에 스캐너 검사를 성공적으로 중지할 수 있다는 보장은 없습니다.

다음은 WIA 관련 HRESULT 오류 코드 목록과 이 함수가 반환하는 표준 COM HRESULT 오류 코드 목록입니다.

참고

(API는 WIA 특정 오류 HRESULT에 대해 WinRTOriginateError 및/또는 OriginateErrorWithResourceString을 호출합니다(모든 특정 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

두 가지 특별한 경우는 다음과 같습니다.

• WIA의 S_FALSE HRESULT는 취소된 비동기 호출(AsyncStatus.Canceled)으로 변환됩니다.
• WIA의 WIA_ERROR_PAPER_EMPTY 이 API에서 파일의 빈 목록(IVectorView.Size가 0으로 설정됨)이 있는 성공적인 반환(AsyncStatus.Completed)으로 변환됩니다. 분리된 파일을 방지하기 위해 이 메서드는 오류가 발생하기 전에 실패 시 이미지를 전송하는 데 사용되는 나머지 고아 파일을 삭제합니다. 메서드는 전송 파일을 임시 파일로 저장하고 스캔 작업이 완료될 때까지 파일을 유지합니다. 앱은 사용자에게 문서를 다시 검사하도록 지시해야 합니다.