Saltar al contenido principal
Este método lo implementa el usuario. ABBYY FineReader Engine puede usar un puntero a la interfaz IImagePasswordCallback en métodos que abren archivos de imagen para solicitar contraseñas de archivos protegidos, concretamente archivos PDF. Una implementación típica de este método podría mostrar un cuadro de diálogo en el que el usuario pueda introducir la contraseña necesaria para acceder al archivo de imagen.

Sintaxis

C++

HRESULT raw_GetPassword(
  VARIANT_BOOL  OwnerNeeded,
  VARIANT_BOOL* IsResultValid,
  BSTR*         Password
);

C#

string GetPassword(
  bool     OwnerNeeded,
  ref bool IsResultValid
);

Visual Basic .NET

Function IImagePasswordCallback_GetPassword( _
  OwnerNeeded As Boolean, _
  ByRef IsResultValid As Boolean _
) As String

Parámetros

OwnerNeeded [in] Este parámetro indica si se solicita la contraseña de usuario (OwnerNeeded=False) o la del propietario (OwnerNeeded=True) para el archivo de imagen en formato PDF. La contraseña del propietario proporciona el nivel más alto de acceso al contenido y las propiedades del documento. IsResultValid [in, out] Este parámetro debe establecerse en TRUE si ABBYY FineReader Engine debe usar el valor de resultado de Password. Cuando se establece en FALSE, ABBYY FineReader Engine actuará como si no hubiera ninguna contraseña disponible y no abrirá el archivo de imagen. El valor predeterminado de este parámetro es FALSE. Password [out, retval] Este parámetro permite devolver la cadena que se utilizará como contraseña para el archivo de imagen.

Valores de retorno

Este método no tiene valores de retorno específicos. Devuelve los valores de retorno estándar de las funciones de ABBYY FineReader Engine.

Observaciones

ABBYY FineReader Engine puede llamar a este método más de una vez, hasta que se devuelva la contraseña correcta o hasta que el parámetro isResultValid se establezca en FALSE, lo que significa que el usuario no puede (o no desea) introducir la contraseña.

Consulte también

IImagePasswordCallback