> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# RecognizeImageFile-Methode des Engine-Objekts

> RecognizeImageFile-Methode des Engine-Objekts in der ABBYY FineReader Engine API — Diese Methode öffnet eine Bilddatei, führt Vorverarbeitung, Layout-Analyse, Erkennung sowie Seiten- und Dokumentensynthese durch und exportiert das Ergebnis im ausgewählten Ausgabeformat.

Diese Methode öffnet die angegebene Bilddatei, führt deren Vorverarbeitung, Layout-Analyse, Erkennung sowie Seiten- und Dokumentensynthese durch und exportiert den erkannten Text in das ausgewählte Ausgabeformat. Die RecognizeImageFile-Methode kann mehrseitige Bilddateien verarbeiten und die Erkennungsergebnisse in eine einzelne Datei exportieren.

<div id="syntax">
  ## Syntax
</div>

<div id="c">
  ### C++
</div>

```cpp theme={null}
HRESULT RecognizeImageFile(
  BSTR                         ImageFileName,
  IPrepareImageMode            PrepareMode,
  IDocumentProcessingParams*   DocumentProcessingParams,
  FileExportFormatEnum         ExportFormat,
  IUnknown*                    ExportParams,
  IImagePasswordCallback*      PasswordCallback,
  BSTR                         OutputFileName
);
```

### C\#

```csharp theme={null}
void RecognizeImageFile(
  string                   ImageFileName,
  IPrepareImageMode         PrepareMode,
  IDocumentProcessingParams DocumentProcessingParams,
  FileExportFormatEnum     ExportFormat,
  object                   ExportParams,
  IImagePasswordCallback   PasswordCallback,
  string                   OutputFileName
);
```

<div id="visual-basic-net">
  ### Visual Basic .NET
</div>

```vb theme={null}
Sub RecognizeImageFile( _
  ImageFileName As String, _
  PrepareMode As IPrepareImageMode, _
  DocumentProcessingParams As IDocumentProcessingParams, _
  ExportFormat As IFileExportFormatEnum, _
  ExportParams As Object, _
  PasswordCallback As IImagePasswordCallback, _
  OutputFileName As String _
)
```

<div id="parameters">
  ## Parameter
</div>

ImageFileName

\[in] Enthält den vollständigen Pfad zu einer Bilddatei, die erkannt werden soll. Wenn diese Datei nicht im internen Format von ABBYY FineReader Engine vorliegt, wird sie mit den Standardwerten der Eigenschaften von [PrepareImageMode](/de/fine-reader/engine/api-reference/image-related-objects/prepareimagemode) vorbereitet, oder, falls ein [Profil](/de/fine-reader/engine/guided-tour/advanced-techniques/working-with-profiles) geladen wurde, werden die in diesem Profil festgelegten Parameter verwendet.

PrepareMode

\[in] Diese Variable verweist auf das Objekt [PrepareImageMode](/de/fine-reader/engine/api-reference/image-related-objects/prepareimagemode), das die Parameter für die Bildkonvertierung in das interne Format speichert. Dieser Parameter kann 0 sein; in diesem Fall werden die Standardparameter des Bildvorbereitungsmodus verwendet, oder, falls ein [Profil](/de/fine-reader/engine/guided-tour/advanced-techniques/working-with-profiles) geladen wurde, werden die in diesem Profil festgelegten Parameter verwendet.

DocumentProcessingParams

\[in] Verweist auf das Objekt [DocumentProcessingParams](/de/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/documentprocessingparams), das alle Verarbeitungsparameter speichert. Dieser Parameter kann 0 sein. In diesem Fall wird das Dokument mit den Standardparametern verarbeitet (alle Verarbeitungsparameter sind auf ihre Standardwerte gesetzt, und die Erkennungssprache ist Englisch), oder, falls ein [Profil](/de/fine-reader/engine/guided-tour/advanced-techniques/working-with-profiles) geladen wurde, werden die in diesem Profil festgelegten Parameter verwendet.

ExportFormat

\[in] Diese Variable vom Typ [FileExportFormatEnum](/de/fine-reader/engine/api-reference/enumerations/fileexportformatenum) gibt das Format der Ausgabedatei an, in die der erkannte Text exportiert wird.

ExportParams

\[in] Über diesen Eingabeparameter übergeben Sie das Objekt mit den Exportparametern des Typs, der Ihrem Dateiformat entspricht. Wenn Sie beispielsweise eine RTF-Datei erstellen, erstellen Sie das Objekt [RTFExportParams](/de/fine-reader/engine/api-reference/parameter-objects/export-parameters/rtfexportparams), legen die erforderlichen Parameter darin fest und übergeben es als Eingabeparameter exporterParams an diese Methode. Dieser Parameter ist optional und kann 0 sein; in diesem Fall werden für die Exportparameter die Standardwerte verwendet, oder, falls ein [Profil](/de/fine-reader/engine/guided-tour/advanced-techniques/working-with-profiles) geladen wurde, werden die in diesem Profil festgelegten Parameter verwendet.

<Warning>
  Unter Linux müssen Sie für diesen Parameter NULL übergeben, wenn Sie mit ABBYY FineReader Engine arbeiten, das out-of-process geladen wurde.
</Warning>

PasswordCallback

\[in] Verweist auf die Schnittstelle des benutzerimplementierten Objekts vom Typ [ImagePasswordCallback](/de/fine-reader/engine/api-reference/image-related-objects/iimagepasswordcallback), die zur Verarbeitung möglicher Passwortabfragen für den Zugriff auf Bilder im PDF-Format verwendet wird. Dieser Parameter ist optional und kann 0 sein; in diesem Fall können passwortgeschützte Dateien nicht verarbeitet werden.

OutputFileName

\[in] Enthält den vollständigen Pfad zur Ausgabedatei, in die der erkannte Text exportiert werden soll. Wenn an diesem Speicherort bereits eine Datei vorhanden ist, wird sie je nach Exportmodus entweder ohne Rückfrage überschrieben oder der erkannte Text an ihr Ende angehängt.

<div id="return-values">
  ## Rückgabewerte
</div>

Wenn die Erkennung vom Benutzer abgebrochen wird, gibt diese Methode E\_ABORT zurück. Wenn das Pattern-Training vom Benutzer abgebrochen wird, gibt diese Methode FREN\_E\_PATTERN\_TRAINING\_ABORTED zurück. Außerdem gibt sie die [Standard-Rückgabecodes der Funktionen von ABBYY FineReader Engine](/de/fine-reader/engine/api-reference/return-codes) zurück.

<div id="remarks">
  ## Hinweise
</div>

Für Linux und Windows: Je nach Wert der Eigenschaft [IEngine::MultiProcessingParams](/de/fine-reader/engine/api-reference/parameter-objects/multiprocessingparams) kann ABBYY FineReader Engine die Verarbeitung mehrseitiger Dokumente auf die CPU-Kerne verteilen.

<div id="see-also">
  ## Siehe auch
</div>

[Engine](/de/fine-reader/engine/api-reference/engine-object-iengine-interface)

[IImagePasswordCallback](/de/fine-reader/engine/api-reference/image-related-objects/iimagepasswordcallback)

[Arbeiten mit Profilen](/de/fine-reader/engine/guided-tour/advanced-techniques/working-with-profiles)