English (English)
OpenImageFileFromMemory Method of the Engine Object
This method opens an image file from the global memory, where it was previously loaded by the user.
Syntax
C++
HRESULT OpenImageFileFromMemory(
__int64 HGlobal,
IImagePasswordCallback* Callback,
IPrepareImageMode* PrepareMode,
BSTR FileName
IImageDocument** Result
);
C#
IImageDocument OpenImageFileFromMemory(
Int64 HGlobal,
IImagePasswordCallback Callback,
IPrepareImageMode PrepareMode,
string FileName
);
Visual Basic .NET
Function OpenImageFileFromMemory( _ HGlobal As Int64, _ Callback As IImagePasswordCallback, _ [PrepareMode As IPrepareImageMode = Nothing], _ [FileName As String = "0"] _ ) As IImageDocument
Parameters
- HGlobal
- [in] Specifies the HGLOBAL handle of the memory block which contains the image file. The handle is passed as __int64. This handle should be valid.
- Callback
- [in] This variable refers to the interface of the user-implemented object of the type ImagePasswordCallback which is used to handle possible password requests for accessing images in PDF format. This parameter is optional and may be 0, in which case password-protected files cannot be processed.
- PrepareMode
- [in] Refers to the PrepareImageMode object which specifies how an image will be preprocessed during opening. This parameter is optional and may be 0, in which case either the default parameters are used, or, if a profile has been loaded, the parameters set by this profile are used.
- FileName
- [in] Specifies the name of the image file. This information is used to define the format of the file, and in error messages. This parameter is optional and may be 0.
- Result
- [out, retval] A pointer to IImageDocument* pointer variable that receives the interface pointer of the resulting ImageDocument object.
Return values
This method has no specific return values. It returns the standard return values of ABBYY FineReader Engine functions.
Remarks
- Notice that for multi-page image files, the ImageDocument object will be created only from the first page. To open all pages of the file, use the AddImageFileFromMemory method of the FRDocument object.
- This method does not work if the Engine object is created using the OutprocLoader object.
- This method does not support WIC-compatible files opening.
See also
17.09.2024 15:14:40