> ## 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.

# IImagePasswordCallback-Schnittstelle

> IImagePasswordCallback-Schnittstelle in der ABBYY FineReader Engine API — clientseitige Schnittstelle, die ein Kennwort bereitstellt, wenn FineReader Engine auf eine kennwortgeschützte Bilddatei zugreifen muss (derzeit nur PDFs).

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](/de/fine-reader/engine/api-reference/document-related-objects/frdocument/addimagefilewithpasswordcallback-method), [IEngine::GetNumberOfPagesInImageFile](/de/fine-reader/engine/api-reference/engine-object-iengine-interface/processing-methods/getnumberofpagesinimagefile-method), [IEngine::RecognizeImageFile](/de/fine-reader/engine/api-reference/engine-object-iengine-interface/processing-methods/recognizeimagefile-method). 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.

<div id="method">
  ## Methode
</div>

| Name                                                                                                                | Beschreibung              |
| ------------------------------------------------------------------------------------------------------------------- | ------------------------- |
| [GetPassword](/de/fine-reader/engine/api-reference/image-related-objects/iimagepasswordcallback/getpassword-method) | Gibt das Kennwort zurück. |

<div id="input-parameter">
  ## Eingabeparameter
</div>

Dieses Objekt wird als Eingabeparameter an folgende Methoden übergeben:

* [OpenImageFileFromMemory](/de/fine-reader/engine/api-reference/engine-object-iengine-interface/processing-methods/openimagefilefrommemory-method), [RecognizeImageFile](/de/fine-reader/engine/api-reference/engine-object-iengine-interface/processing-methods/recognizeimagefile-method), [GetNumberOfPagesInImageFile](/de/fine-reader/engine/api-reference/engine-object-iengine-interface/processing-methods/getnumberofpagesinimagefile-method), [IsPdfPortfolio](/de/fine-reader/engine/api-reference/engine-object-iengine-interface/processing-methods/ispdfportfolio-method), [IsPdfPortfolioFromStream](/de/fine-reader/engine/api-reference/engine-object-iengine-interface/processing-methods/ispdfportfoliofromstream-method), [IsPdfWithTextualContent](/de/fine-reader/engine/api-reference/engine-object-iengine-interface/processing-methods/ispdfwithtextualcontent-method), [IsPdfWithTextualContentFromStream](/de/fine-reader/engine/api-reference/engine-object-iengine-interface/processing-methods/ispdfwithtextualcontentfromstream-method) und [InjectTextLayer](/de/fine-reader/engine/api-reference/engine-object-iengine-interface/processing-methods/injecttextlayer-method) des [Engine](/de/fine-reader/engine/api-reference/engine-object-iengine-interface)-Objekts.
* [AddImageFileFromAttachment](/de/fine-reader/engine/api-reference/document-related-objects/frdocument/addimagefilefromattachment-method) und [AddImageFileWithPasswordCallback](/de/fine-reader/engine/api-reference/document-related-objects/frdocument/addimagefilewithpasswordcallback-method) des [FRDocument](/de/fine-reader/engine/api-reference/document-related-objects/frdocument)-Objekts.

<div id="samples">
  ## Beispiele
</div>

Die Schnittstelle kommt in den folgenden Codebeispielen zum Einsatz: [CommandLineInterface](/de/fine-reader/engine/guided-tour/samples#commandlineinterface) (Windows und Linux).

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

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