ImageScanner.ScanFilesToFolderAsync Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Startet einen Scanauftrag mit der angegebenen Scanquelle und schreibt ein oder mehrere Bilder in eine mehrseitige Datei wie TIFF, XPS und PDF. oder eine oder mehrere Single-Page-Dateien wie DIB, PNG, JPG und TIFF am angegebenen Ordnerspeicherort. Gibt den Status der Überprüfung zurück.
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)Parameter
- scanSource
- ImageScannerScanSource
Die Quelle für die Bildüberprüfung.
- storageFolder
- StorageFolder
Der Zielordnerspeicherort der gescannten Datei.
Gibt zurück
Windows.Foundation.IAsyncOperationWithProgress<Windows.Devices.Scanners.ImageScannerScanResult,unsigned int>
IAsyncOperationWithProgress<ImageScannerScanResult,uint32_t>
Die Liste der gescannten Bilddateien aus ImageScannerScanResult und der Fortschritt des WIA-Scanauftrags von UInt32, der angibt, wie viele Dateien in den Zielordner übertragen wurden.
- Attribute
Hinweise
Die Dateien werden mit temporären Namen benannt und verfügen über eine Standarddateierweiterung, die vom Dateiformattyp abhängt.
Hinweis
Wenn diese Methode in der UWP-App aufgerufen wird, muss die App sichtbar sein und im Vordergrund ausgeführt werden.
Wenn die App den asynchronen Aufruf abbricht, initiiert sie eine Abbruchanforderung des aktuellen Scanauftrags. Es gibt keine Garantie dafür, dass der Scanauftrag abgebrochen wird, wenn die App den asynchronen Aufruf abbricht. Wenn der Abbruch durchläuft, kann der Scanner aus den folgenden Gründen beendet werden:
- Es dauert einige Sekunden, bis der Scanner den Scanvorgang beendet.
- Er wird nur beendet, wenn das Papier nicht mehr verfügbar ist (für einen Feedererwerb).
- Es schließt die Ausführung des Scankopfes bis zum Ende des Bettes ab und kehrt den Scankopf dann vollständig an seinen geparkten Ort zurück (für einen Flachbetterwerb).
Intern kennzeichnet die asynchrone Abbruch den aktuellen WIA 2.0-Scanauftrag als abgebrochen innerhalb der App. Wenn das WIA-Gerät den nächsten Rückruf an den WIA-Dienst vornimmt, wird der Auftragsabbruch möglicherweise erfolgreich an den WIA-Treiber übermittelt. Aber selbst wenn der WIA-Treiber die Abbruchanforderung von einem seiner Rückrufe empfängt, gibt es keine Garantie, dass der Treiber den Scanvorgang erfolgreich beenden kann, sofort oder nach einem vorhersagbaren Zeitraum.
Dies ist die Liste der WIA-spezifischen HRESULT-Fehlercodes sowie der standardmäßigen COM HRESULT-Fehlercodes, die von dieser Funktion zurückgegeben werden.
Hinweis
(Die API ruft WinRTOriginateError und/oder OriginateErrorWithResourceString auf (alle spezifischen WIA-Fehler enthalten lokalisierbare Fehlerbeschreibungen) für die WIA-spezifischen Fehler-HRESULTs):
| 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 |
Es gibt zwei Sonderfälle:
- Das HRESULT der WIA S_FALSE wird in einen abgebrochenen asynchronen Aufruf (AsyncStatus.Canceled) übersetzt.
- Die WIA_ERROR_PAPER_EMPTY der WIA wird von dieser API in eine erfolgreiche Rückgabe (AsyncStatus.Completed) mit einer leeren Liste von Dateien übersetzt (IVectorView.Size auf 0 festgelegt). Um verwaiste Dateien zu verhindern, löscht diese Methode alle verbleibenden verwaisten Dateien, die zum Übertragen von Bildern bei einem Fehler verwendet werden, bevor der Fehler aufgetreten ist. Die -Methode speichert die Übertragungsdateien als temporäre Dateien und behält sie bis zum Abschluss des Scanauftrags bei. Die App muss den Benutzer anweisen, das Dokument erneut zu scannen.