엔진 객체의 OpenImageFileFromMemory 메서드

이 메서드는 사용자가 이전에 전역 메모리에 로드해 둔 이미지 파일을 엽니다.

​

구문

​

C++

​

Linux 및 macOS

HRESULT OpenImageFileFromMemory(
  void*                   DataPtr,
  __int64                 DataSize,
  IImagePasswordCallback* Callback,
  IPrepareImageMode*      PrepareMode,
  BSTR                    FileName
  IImageDocument**        Result
);

​

Windows

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

​

매개변수

DataPtr

[in] Linux: 이미지 파일이 들어 있는 메모리 블록의 주소를 지정합니다.

DataSize

[in] Linux: 메모리에 로드된 이미지의 크기를 지정합니다.

HGlobal

[in] macOS and Windows: 이미지 파일이 들어 있는 메모리 블록의 HGLOBAL 핸들을 지정합니다. 핸들은 __int64로 전달됩니다. 이 핸들은 유효해야 합니다.

Callback

[in] PDF 형식 이미지에 액세스할 때 발생할 수 있는 암호 요청을 처리하는 데 사용되는, 사용자가 구현한 ImagePasswordCallback 형식 객체의 인터페이스를 가리키는 변수입니다. 이 매개변수는 선택 사항이며 0일 수 있습니다. 이 경우 암호로 보호된 파일은 처리할 수 없습니다.

PrepareMode

[in] 이미지를 열 때 이미지가 어떻게 전처리되는지를 지정하는 PrepareImageMode 객체를 참조합니다. 이 매개변수는 선택 사항이며 0일 수 있습니다. 이 경우 기본 매개변수가 사용되거나, profile이 로드된 경우 해당 프로필에 설정된 매개변수가 사용됩니다.

FileName

[in] 이미지 파일 이름을 지정합니다. 이 정보는 파일 형식을 판별하고 오류 메시지에 사용됩니다. 이 매개변수는 선택 사항이며 0일 수 있습니다.

Result

[out, retval] 결과 ImageDocument 객체의 인터페이스 포인터를 받는 IImageDocument* 포인터 변수에 대한 포인터입니다.

​

반환 값

이 메서드에는 별도의 반환 값이 없습니다. 대신 ABBYY FineReader 엔진 함수의 표준 반환 값을 반환합니다.

​

비고

• 여러 페이지로 구성된 이미지 파일의 경우, ImageDocument 객체는 첫 번째 페이지에서만 생성된다는 점에 유의하세요. 파일의 모든 페이지를 열려면 FRDocument 객체의 AddImageFileFromMemory 메서드를 사용하세요.
• Linux에서 엔진이 프로세스 외부 서버로 로드되었거나 Windows에서 OutprocLoader 객체를 사용해 객체를 생성한 경우에는 이 메서드가 작동하지 않습니다.
• Windows에서는 이 메서드로 WIC 호환 파일을 열 수 없습니다.

​

참고 항목

엔진

IFRDocument::AddImageFileFromMemory