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

> Método AddImageFileFromStream del objeto FRDocument en la API de ABBYY FineReader Engine: abre un archivo de imagen desde un flujo de entrada implementado por el usuario y agrega sus páginas al documento; funciona con OutprocLoader en Windows.

Este método abre un archivo de imagen desde un flujo de entrada implementado por el usuario y agrega al documento las páginas correspondientes al archivo abierto.

En Windows, este método se diferencia del método [AddImageFileFromMemory](/es/fine-reader/engine/api-reference/document-related-objects/frdocument/addimagefilefrommemory-method) en que puede usarse cuando el objeto Engine se crea mediante el objeto [OutprocLoader](/es/fine-reader/engine/api-reference/engine-loaders/outprocloader).

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

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

```cpp theme={null}
HRESULT AddImageFileFromStream(
  IReadStream*            Stream,
  IImagePasswordCallback* Callback,
  IPrepareImageMode*      PrepareMode,
  IIntsCollection*        PageIndices,
  BSTR                    FileName
);
```

### C\#

```csharp theme={null}
void AddImageFileFromStream(
  IReadStream             Stream,
  IImagePasswordCallback  Callback,
  IPrepareImageMode       PrepareMode,
  IIntsCollection         PageIndices,
  string                  FileName
);
```

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

```vb theme={null}
Sub AddImageFileFromStream( _
  Stream As IReadStream, _
  Callback As IImagePasswordCallback, _
  [PrepareMode As IPrepareImageMode = Nothing], _
  [PageIndices As IIntsCollection = Nothing], _
  [FileName As String = "0"] _
)
```

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

Stream

\[in] Hace referencia a la interfaz del objeto implementado por el usuario del tipo [IReadStream](/es/fine-reader/engine/api-reference/supplementary-objects-and-methods/ireadstream), que contiene el archivo de imagen que se agregará al documento.

Callback

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

PrepareMode

\[in] Hace referencia al objeto [PrepareImageMode](/es/fine-reader/engine/api-reference/image-related-objects/prepareimagemode), que especifica cómo se preprocesará una imagen al abrirla. Este parámetro es opcional y puede ser 0; en ese caso, se usarán los parámetros predeterminados o, si se ha cargado un [perfil](/es/fine-reader/engine/guided-tour/advanced-techniques/working-with-profiles), los parámetros definidos por ese perfil.

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 agregarse al documento. Tenga en cuenta que no se permiten índices repetidos. Para agregar 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, se agregarán al documento todas las páginas del archivo abierto.

FileName

\[in] Especifica el nombre del archivo de imagen. Esta información se utiliza para determinar el formato del archivo, si no se especifica explícitamente, y en los mensajes de error. Este parámetro es opcional y puede ser 0.

En Windows y Linux: para abrir formatos ofimáticos, pase el nombre del documento con su extensión.

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

* Los archivos en formato SVG no pueden abrirse desde un flujo.
* Al abrir un archivo PDF Portfolio con este método, su portada siempre se incluye en el archivo de salida.
* Este método puede notificar eventos a los agentes de escucha asociados a la interfaz IConnectionPointContainer del objeto [FRDocument](/es/fine-reader/engine/api-reference/document-related-objects/frdocument).
* Para Linux y Windows:
  * Si su licencia incluye el módulo [Office Formats Opening](/es/fine-reader/engine/licensing/modules#officeformatsopening), también puede usar este método para abrir documentos digitales en [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 servidor fuera de proceso.
* Para Windows: Este método no admite la apertura de archivos compatibles con WIC.

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

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