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

# Objeto Handle (interfaz IHandle)

> Objeto Handle (interfaz IHandle) en la API de ABBYY FineReader Engine: proporciona acceso al handle de un recurso en memoria (mapa de bits o bloque de memoria), administra la asignación de memoria y evita fugas; no está disponible fuera del proceso.

Este objeto proporciona acceso al handle de un recurso en memoria. Lo devuelven algunos métodos que proporcionan acceso a una imagen de mapa de bits o a un bloque de memoria. El objeto administra la asignación de memoria y le permite evitar fugas de memoria al trabajar con estos recursos.

<Warning>
  Esta interfaz no admite automatización. Esto significa que no funciona en Linux ni en Windows si FineReader Engine se carga como un servidor fuera del proceso.
</Warning>

El objeto se usa en las siguientes situaciones:

* Si planea trabajar con el recurso fuera de FineReader Engine

Puede obtener el handle del recurso mediante la propiedad Handle y trabajar con él. En este caso, si libera el objeto Handle, el recurso también se libera. O bien, puede obtener el handle y desacoplar de él el objeto Handle (use el método Detach). En este caso, usted es responsable de liberar el recurso.

* Si planea pasar el recurso a otros métodos de FineReader Engine

Puede obtener el handle del recurso como \_\_int64 mediante la propiedad HandleAsInt64. Después, puede pasar el valor de esta propiedad a un método de FineReader Engine que lo requiera. Si libera el objeto Handle, el recurso también se libera. Puede liberar el recurso manualmente llamando al método CloseHandle."

<div id="properties">
  ## Propiedades
</div>

| Name          | Tipo                                                                                                                                                                                                                      | Descripción                                                                                                                                                                                                                                                      |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Application   | [Engine](/es/fine-reader/engine/api-reference/engine-object-iengine-interface), [de solo lectura](/es/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties#readonly_properties) | Devuelve el objeto Engine.                                                                                                                                                                                                                                       |
| Handle        | [HANDLE\*](/es/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties), de solo lectura                                                                                           | Devuelve el handle del recurso. Puede obtener el handle mediante esta propiedad y usar el recurso.                                                                                                                                                               |
| HandleAsInt64 | [\_\_int64](/es/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties), de solo lectura                                                                                          | Devuelve el handle del recurso como [\_\_int64](/es/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties). Puede pasar el valor devuelto de esta propiedad a un método de FineReader Engine como parámetro de entrada. |

<div id="methods">
  ## Métodos
</div>

| Nombre                                                                                                          | Descripción                                  |
| --------------------------------------------------------------------------------------------------------------- | -------------------------------------------- |
| [CloseHandle](/es/fine-reader/engine/api-reference/supplementary-objects-and-methods/handle/closehandle-method) | Libera el recurso.                           |
| [Detach](/es/fine-reader/engine/api-reference/supplementary-objects-and-methods/handle/detach-method)           | Devuelve el handle y separa el objeto de él. |

<div id="output-parameter">
  ## Parámetro de salida
</div>

Este objeto es el parámetro de salida de los siguientes métodos:

* método [GetBitmap](/es/fine-reader/engine/api-reference/image-related-objects/image/getbitmap-method) del objeto [Image](/es/fine-reader/engine/api-reference/image-related-objects/image)
* método [SaveToMemory](/es/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetomemory-method) de varios objetos (Windows)

<div id="samples">
  ## Ejemplos
</div>

<Accordion title="Código C#">
  ```csharp theme={null}
  FREngine.IEngine engine;
  FREngine.IFRDocument frdoc;
  // Suponemos que el documento ya se ha creado y que se le han añadido imágenes
  // Obtenga el handle del mapa de bits de un plano de imagen en color de una página del documento
  FREngine.IFRPage page = frDoc.Pages[0];
  FREngine.IImageDocument imageDoc = page.ImageDocument;
  FREngine.IImage image = imageDoc.ColorImage;
  FREngine.IHandle hBitmap = image.GetBitmap( null );
  // Trabaje con el mapa de bits
  System.Drawing.IImage preprocessedImage = System.Drawing.Image.FromHbitmap( hBitmap.Handle );
  ...
  Gdi32.DeleteObject( hBitmap );
  ```
</Accordion>

El objeto se utiliza en las siguientes herramientas de demostración de Windows: [Perfiles de procesamiento predefinidos del motor](/es/fine-reader/engine/guided-tour/samples#engine_predefined_processing_profiles).

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

[Uso de Propiedades](/es/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties)