Interfaz IImagePasswordCallback

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, IEngine::GetNumberOfPagesInImageFile, IEngine::RecognizeImageFile, 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.

​

Método

Nombre	Descripción
GetPassword	Devuelve la contraseña.

​

Parámetro de entrada

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

• los métodos OpenImageFileFromMemory, RecognizeImageFile, GetNumberOfPagesInImageFile, IsPdfPortfolio, IsPdfPortfolioFromStream, IsPdfWithTextualContent, IsPdfWithTextualContentFromStream e InjectTextLayer del objeto Engine.
• los métodos AddImageFileFromAttachment y AddImageFileWithPasswordCallback del objeto FRDocument.

​

Ejemplos

La interfaz se utiliza en los siguientes ejemplos de código: CommandLineInterface (Windows y Linux).

​

Observaciones

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