跳轉到主要內容
此方法由使用者實作。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