Zum Hauptinhalt springen
Diese Schnittstelle muss clientseitig implementiert werden. Sie enthält eine Methode, die ein Kennwort zurückgeben kann, wenn dieses für den Zugriff auf die Bilddatei benötigt wird. Derzeit können nur Dateien im PDF-Format mit Kennwörtern geschützt werden. Die Verwendung dieser Schnittstelle erfolgt in folgender Reihenfolge:
  1. Der Benutzer von ABBYY FineReader Engine implementiert ein Objekt mit der IImagePasswordCallback-Schnittstelle. Für C++ sollte dieses Objekt von dieser Schnittstelle abgeleitet sein und deren raw_GetPassword-Methode implementieren. Dieses Objekt sollte außerdem die Methoden der IUnknown-Schnittstelle implementieren.
  2. Der Benutzer übergibt dann einen Zeiger auf die Schnittstelle dieses Objekts als einen der Eingabeparameter an eine der Methoden IFRDocument::AddImageFileWithPasswordCallback, IEngine::GetNumberOfPagesInImageFile, IEngine::RecognizeImageFile. ABBYY FineReader Engine ruft bei Bedarf die GetPassword-Methode dieses Objekts auf, um das Kennwort abzurufen.
Falls der Benutzer nicht damit rechnet, mit kennwortgeschützten Bilddateien zu arbeiten, oder Kennwortabfragen nicht verarbeiten möchte, kann anstelle des Zeigers auf die IImagePasswordCallback-Schnittstelle ein NULL-Zeiger übergeben werden. Der einzige Nachteil dieses Ansatzes besteht darin, dass kennwortgeschützte Bilddateien nicht mit ABBYY FineReader Engine geöffnet werden.

​
Methode

NameBeschreibung
GetPasswordGibt das Kennwort zurück.

​
Eingabeparameter

Dieses Objekt wird als Eingabeparameter an folgende Methoden übergeben:

​
Beispiele

Die Schnittstelle kommt in den folgenden Codebeispielen zum Einsatz: CommandLineInterface (Windows und Linux).

​
Hinweise

Unter Linux funktioniert diese Schnittstelle nicht, wenn das Engine-Objekt als Out-of-Process-Server geladen wird.