IImagePasswordCallback 인터페이스의 GetPassword 메서드

이 메서드는 사용자가 구현합니다. ABBYY FineReader Engine은 이미지 파일을 여는 메서드에서 IImagePasswordCallback 인터페이스에 대한 포인터를 사용해 보호된 파일(즉, PDF 파일)의 암호를 요청할 수 있습니다. 이 메서드는 일반적으로 사용자가 이미지 파일에 액세스하는 데 필요한 암호를 입력할 수 있는 대화 상자를 표시하도록 구현할 수 있습니다.

​

구문

​

C++

HRESULT raw_GetPassword(
  VARIANT_BOOL  OwnerNeeded,
  VARIANT_BOOL* IsResultValid,
  BSTR*         Password
);

​

C#

string GetPassword(
  bool     OwnerNeeded,
  ref bool IsResultValid
);

​

Visual Basic .NET

Function IImagePasswordCallback_GetPassword( _
  OwnerNeeded As Boolean, _
  ByRef IsResultValid As Boolean _
) As String

​

매개변수

OwnerNeeded

[in] 이 매개변수는 PDF 형식의 이미지 파일에 대해 사용자 암호(OwnerNeeded=False) 또는 소유자 암호(OwnerNeeded=True) 중 어느 암호를 요청할지 나타냅니다. 소유자 암호는 문서의 내용과 속성에 대한 가장 높은 수준의 접근 권한을 제공합니다.

IsResultValid

[in, out] 이 매개변수는 Password에 반환된 값을 ABBYY FineReader Engine에서 사용해야 하는 경우 TRUE로 설정해야 합니다. FALSE로 설정하면 ABBYY FineReader Engine은 사용할 수 있는 암호가 없는 것처럼 동작하며 이미지 파일을 열지 않습니다. 이 매개변수의 기본값은 FALSE입니다.

Password

[out, retval] 이 매개변수를 사용하면 이미지 파일의 암호로 사용할 string을 반환할 수 있습니다.

​

반환 값

이 메서드에는 고유한 반환 값이 없습니다. ABBYY FineReader Engine 함수의 표준 반환 값을 반환합니다.

​

비고

이 메서드는 올바른 암호가 반환되거나 isResultValid 매개 변수가 FALSE로 설정될 때까지 ABBYY FineReader Engine에 의해 여러 번 호출될 수 있습니다. 이는 사용자가 암호를 입력할 수 없거나 입력할 의사가 없음을 의미합니다.

​

참고 항목

IImagePasswordCallback