跳转到主要内容
此方法由用户实现。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] 如果 ABBYY FineReader Engine 应使用 Password 中的结果值，则应将此参数设为 TRUE。设为 FALSE 时，ABBYY FineReader Engine 将视为没有可用密码，因此不会打开图像文件。此参数的默认值为 FALSE。 Password [out, retval] 此参数允许您返回用作图像文件密码的 string。

​
返回值

此方法没有特定的返回值，而是返回 ABBYY FineReader Engine 函数的标准返回值。

​
备注

ABBYY FineReader Engine 可能会多次调用此方法，直到返回正确的密码，或者将 isResultValid 参数设置为 FALSE；这表示用户无法 (或不想) 输入密码。

​
另请参见

IImagePasswordCallback