> ## 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 AddImageFileWithPasswordCallback del objeto FRDocument

> Método AddImageFileWithPasswordCallback del objeto FRDocument en la API de ABBYY FineReader Engine — abre un archivo de imagen mediante un IImagePasswordCallback y agrega sus páginas al documento; emite eventos de IConnectionPoint.

Este método abre un archivo de imagen mediante la interfaz [IImagePasswordCallback](/es/fine-reader/engine/api-reference/image-related-objects/iimagepasswordcallback) y agrega al documento las páginas correspondientes al archivo abierto.

Este método puede notificar eventos a los listeners asociados a la interfaz IConnectionPointContainer del objeto [FRDocument](/es/fine-reader/engine/api-reference/document-related-objects/frdocument).

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

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

```cpp theme={null}
HRESULT AddImageFileWithPasswordCallback(
  BSTR                    ImageFileName, 
  IImagePasswordCallback* Callback,
  IPrepareImageMode*      PrepareMode,
  IIntsCollection*        PageIndices   
);
```

### C\#

```csharp theme={null}
void AddImageFileWithPasswordCallback(
  string                 ImageFileName, 
  IImagePasswordCallback Callback,
  IPrepareImageMode       PrepareMode,
  IIntsCollection         PageIndices   
);
```

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

```vb theme={null}
Sub AddImageFileWithPasswordCallback( _
  ImageFileName As String, _
  Callback As IImagePasswordCallback, _
  [PrepareMode As IPrepareImageMode = Nothing], _
  [PageIndices As IIntsCollection = Nothing] _
)
```

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

ImageFileName

\[in] Esta variable contiene la ruta completa del archivo de imagen que se va a abrir.

Callback

\[in] Esta variable hace referencia a la interfaz del objeto de tipo [ImagePasswordCallback](/es/fine-reader/engine/api-reference/image-related-objects/iimagepasswordcallback) implementado por el usuario, que se utiliza para gestionar las posibles solicitudes de contraseña para acceder a imágenes en formato PDF. Este parámetro es opcional y puede ser 0; en ese caso, no se podrán procesar los archivos protegidos con contraseña.

PrepareMode

\[in] Este parámetro hace referencia al objeto [PrepareImageMode](/es/fine-reader/engine/api-reference/image-related-objects/prepareimagemode), que especifica cómo se preprocesará una imagen durante la apertura.

PageIndices

\[in] Este parámetro hace referencia al objeto [IntsCollection](/es/fine-reader/engine/api-reference/supplementary-objects-and-methods/intscollection), que especifica los índices de las páginas que deben añadirse a un documento. Tenga en cuenta que no se permiten índices repetidos. Para añadir la misma página varias veces, llame a este método varias veces.<br />Este parámetro es opcional y puede ser 0; en ese caso, todas las páginas del archivo abierto se añadirán al documento.

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

* Al abrir un archivo PDF Portfolio con este método, la portada siempre se incluye en el archivo de salida.
* Para Linux y Windows:
  * Si su licencia incluye el módulo [Apertura de formatos ofimáticos](/es/fine-reader/engine/licensing/modules#officeformatsopening), también puede utilizar este método para abrir documentos digitales de [formatos compatibles](/es/fine-reader/engine/specifications/supported-digital-document-input-formats).
  * Según el valor de la propiedad [IEngine::MultiProcessingParams](/es/fine-reader/engine/api-reference/engine-object-iengine-interface/properties#multiprocessingparams), ABBYY FineReader Engine puede distribuir la apertura de documentos de varias páginas entre los núcleos de la CPU.
* Para Linux: Este método no funciona si el objeto Engine se carga como un servidor fuera del proceso.

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

[FRDocument](/es/fine-reader/engine/api-reference/document-related-objects/frdocument)

[AddImageFileWithPassword](/es/fine-reader/engine/api-reference/document-related-objects/frdocument/addimagefilewithpassword-method)

[AddImageFile](/es/fine-reader/engine/api-reference/document-related-objects/frdocument/addimagefile-method)

[Trabajar con imágenes](/es/fine-reader/engine/guided-tour/advanced-techniques/working-with-images)