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

# Método GetPassword de la interfaz IImagePasswordCallback

> Método GetPassword de la interfaz IImagePasswordCallback en la API de ABBYY FineReader Engine: método del lado del cliente que devuelve una contraseña a FineReader Engine al abrir un archivo de imagen protegido con contraseña; normalmente muestra un cuadro de diálogo para que el usuario la introduzca.

Este método lo implementa el usuario. ABBYY FineReader Engine puede usar un puntero a la interfaz [IImagePasswordCallback](/es/fine-reader/engine/api-reference/image-related-objects/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.

<div id="syntax">
  ## Sintaxis
</div>

<div id="c">
  ### C++
</div>

```cpp theme={null}
HRESULT raw_GetPassword(
  VARIANT_BOOL  OwnerNeeded,
  VARIANT_BOOL* IsResultValid,
  BSTR*         Password
);
```

### C\#

```csharp theme={null}
string GetPassword(
  bool     OwnerNeeded,
  ref bool IsResultValid
);
```

<div id="visual-basic-net">
  ### Visual Basic .NET
</div>

```vb theme={null}
Function IImagePasswordCallback_GetPassword( _
  OwnerNeeded As Boolean, _
  ByRef IsResultValid As Boolean _
) As String
```

<div id="parameters">
  ## Parámetros
</div>

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.

<div id="return-values">
  ## Valores de retorno
</div>

Este método no tiene valores de retorno específicos. Devuelve los [valores de retorno estándar de las funciones de ABBYY FineReader Engine](/es/fine-reader/engine/api-reference/return-codes).

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

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.

<div id="see-also">
  ## Consulte también
</div>

[IImagePasswordCallback](/es/fine-reader/engine/api-reference/image-related-objects/iimagepasswordcallback)