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

# Interface IImagePasswordCallback

> Interface IImagePasswordCallback dans l’API ABBYY FineReader Engine — Interface côté client qui fournit un mot de passe lorsque FineReader Engine doit accéder à un fichier image protégé par mot de passe (actuellement, PDF uniquement).

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

<div id="method">
  ## Méthode
</div>

| Nom                                                                                                                 | Description              |
| ------------------------------------------------------------------------------------------------------------------- | ------------------------ |
| [GetPassword](/fr/fine-reader/engine/api-reference/image-related-objects/iimagepasswordcallback/getpassword-method) | Renvoie le mot de passe. |

<div id="input-parameter">
  ## Paramètre d’entrée
</div>

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

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

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

Cette interface est utilisée dans les exemples de code suivants : [CommandLineInterface](/fr/fine-reader/engine/guided-tour/samples#commandlineinterface) (Windows et Linux).

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

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