Interface IImagePasswordCallback

Cette interface doit être implémentée côté client. Elle contient une méthode qui peut retourner un mot de passe lorsqu’il est nécessaire d’accéder au fichier image. Actuellement, seuls les fichiers au format PDF peuvent être protégés par un mot de passe.

La séquence d’utilisation de cette interface est la suivante :

1. L’utilisateur d’ABBYY FineReader Engine implémente un objet avec l’interface IImagePasswordCallback. En C++, cet objet doit dériver de cette interface et implémenter sa méthode raw_GetPassword. Cet objet doit également implémenter les méthodes de l’interface IUnknown.
2. L’utilisateur passe ensuite un pointeur vers l’interface de cet objet à l’une des méthodes IFRDocument::AddImageFileWithPasswordCallback, IEngine::GetNumberOfPagesInImageFile, IEngine::RecognizeImageFile, comme l’un des paramètres d’entrée. ABBYY FineReader Engine appellera la méthode GetPassword de cet objet pour obtenir le mot de passe si nécessaire.

Si l’utilisateur ne prévoit pas de traiter des fichiers image protégés par un mot de passe ou ne souhaite pas gérer les demandes de mot de passe, il peut transmettre le pointeur NULL à la place du pointeur vers l’interface IImagePasswordCallback. Le seul inconvénient de cette approche est que les fichiers image protégés par un mot de passe ne seront pas ouverts avec ABBYY FineReader Engine.

​

Méthode

Nom	Description
GetPassword	Renvoie le mot de passe.

​

Paramètre d’entrée

Cet objet est passé comme paramètre d’entrée aux méthodes suivantes :

• méthodes OpenImageFileFromMemory, RecognizeImageFile, GetNumberOfPagesInImageFile, IsPdfPortfolio, IsPdfPortfolioFromStream, IsPdfWithTextualContent, IsPdfWithTextualContentFromStream et InjectTextLayer de l’objet Engine.
• méthodes AddImageFileFromAttachment et AddImageFileWithPasswordCallback de l’objet FRDocument.

​

Exemples

Cette interface est utilisée dans les exemples de code suivants : CommandLineInterface (Windows et Linux).

​

Remarques

Sous Linux, cette interface ne fonctionne pas si l’objet Engine est chargé comme serveur dans un processus distinct.