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

# Interfaz IImagePasswordCallback

> Interfaz IImagePasswordCallback en la API de ABBYY FineReader Engine: interfaz del lado del cliente que proporciona una contraseña cuando FineReader Engine necesita acceder a un archivo de imagen protegido con contraseña (actualmente, solo archivos PDF).

Esta interfaz debe implementarse del lado del cliente. Contiene un método que puede devolver una contraseña cuando esta se necesite para acceder al archivo de imagen. Actualmente, solo los archivos en formato PDF pueden estar protegidos con contraseña.

La secuencia de uso de esta interfaz es la siguiente:

1. El usuario de ABBYY FineReader Engine implementa un objeto con la interfaz IImagePasswordCallback. En C++, este objeto debe derivar de esta interfaz e implementar su método raw\_GetPassword. Este objeto también debe implementar los métodos de la interfaz IUnknown.
2. A continuación, el usuario pasa un puntero a la interfaz de este objeto a cualquiera de los métodos [IFRDocument::AddImageFileWithPasswordCallback](/es/fine-reader/engine/api-reference/document-related-objects/frdocument/addimagefilewithpasswordcallback-method), [IEngine::GetNumberOfPagesInImageFile](/es/fine-reader/engine/api-reference/engine-object-iengine-interface/processing-methods/getnumberofpagesinimagefile-method), [IEngine::RecognizeImageFile](/es/fine-reader/engine/api-reference/engine-object-iengine-interface/processing-methods/recognizeimagefile-method), como uno de los parámetros de entrada. ABBYY FineReader Engine llamará al método GetPassword de este objeto para obtener la contraseña, si es necesario.

Si el usuario no prevé trabajar con archivos de imagen protegidos con contraseña o no desea gestionar solicitudes de contraseña, puede pasarse el puntero NULL en lugar del puntero a la interfaz IImagePasswordCallback. La única desventaja de este enfoque es que ABBYY FineReader Engine no abrirá los archivos de imagen protegidos con contraseña.

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

| Nombre                                                                                                              | Descripción             |
| ------------------------------------------------------------------------------------------------------------------- | ----------------------- |
| [GetPassword](/es/fine-reader/engine/api-reference/image-related-objects/iimagepasswordcallback/getpassword-method) | Devuelve la contraseña. |

<div id="input-parameter">
  ## Parámetro de entrada
</div>

Este objeto se pasa como parámetro de entrada a los siguientes métodos:

* los métodos [OpenImageFileFromMemory](/es/fine-reader/engine/api-reference/engine-object-iengine-interface/processing-methods/openimagefilefrommemory-method), [RecognizeImageFile](/es/fine-reader/engine/api-reference/engine-object-iengine-interface/processing-methods/recognizeimagefile-method), [GetNumberOfPagesInImageFile](/es/fine-reader/engine/api-reference/engine-object-iengine-interface/processing-methods/getnumberofpagesinimagefile-method), [IsPdfPortfolio](/es/fine-reader/engine/api-reference/engine-object-iengine-interface/processing-methods/ispdfportfolio-method), [IsPdfPortfolioFromStream](/es/fine-reader/engine/api-reference/engine-object-iengine-interface/processing-methods/ispdfportfoliofromstream-method), [IsPdfWithTextualContent](/es/fine-reader/engine/api-reference/engine-object-iengine-interface/processing-methods/ispdfwithtextualcontent-method), [IsPdfWithTextualContentFromStream](/es/fine-reader/engine/api-reference/engine-object-iengine-interface/processing-methods/ispdfwithtextualcontentfromstream-method) e [InjectTextLayer](/es/fine-reader/engine/api-reference/engine-object-iengine-interface/processing-methods/injecttextlayer-method) del objeto [Engine](/es/fine-reader/engine/api-reference/engine-object-iengine-interface).
* los métodos [AddImageFileFromAttachment](/es/fine-reader/engine/api-reference/document-related-objects/frdocument/addimagefilefromattachment-method) y [AddImageFileWithPasswordCallback](/es/fine-reader/engine/api-reference/document-related-objects/frdocument/addimagefilewithpasswordcallback-method) del objeto [FRDocument](/es/fine-reader/engine/api-reference/document-related-objects/frdocument).

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

La interfaz se utiliza en los siguientes ejemplos de código: [CommandLineInterface](/es/fine-reader/engine/guided-tour/samples#commandlineinterface) (Windows y Linux).

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

En Linux, esta interfaz no funciona si el objeto Engine se carga como servidor fuera del proceso.