> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# IImagePasswordCallback インターフェイス

> ABBYY FineReader Engine API の IImagePasswordCallback インターフェイス — FineReader Engine がパスワードで保護された画像ファイル（現時点では PDF のみ）にアクセスする必要がある場合に、パスワードを提供するクライアント側インターフェイス。

このインターフェイスはクライアント側で実装する必要があります。画像ファイルへのアクセス時にパスワードが必要になった場合に、そのパスワードを返すメソッドが含まれています。現在、パスワード保護に対応しているのは PDF 形式のファイルのみです。

このインターフェイスの使用手順は次のとおりです。

1. ABBYY FineReader Engine のユーザーは、IImagePasswordCallback インターフェイスを実装したオブジェクトを作成します。C++ の場合、このオブジェクトはこのインターフェイスから派生し、その `raw\_GetPassword` メソッドを実装する必要があります。また、このオブジェクトでは IUnknown インターフェイスのメソッドも実装する必要があります。
2. 次に、ユーザーはこのオブジェクトのインターフェイスへのポインターを、[IFRDocument::AddImageFileWithPasswordCallback](/ja/fine-reader/engine/api-reference/document-related-objects/frdocument/addimagefilewithpasswordcallback-method)、[IEngine::GetNumberOfPagesInImageFile](/ja/fine-reader/engine/api-reference/engine-object-iengine-interface/processing-methods/getnumberofpagesinimagefile-method)、[IEngine::RecognizeImageFile](/ja/fine-reader/engine/api-reference/engine-object-iengine-interface/processing-methods/recognizeimagefile-method) のいずれかのメソッドに、入力パラメーターの 1 つとして渡します。必要に応じて、ABBYY FineReader Engine はこのオブジェクトの GetPassword メソッドを呼び出してパスワードを取得します。

ユーザーがパスワード保護された画像ファイルを扱う予定がない場合、またはパスワードの要求を処理したくない場合は、IImagePasswordCallback インターフェイスへのポインターの代わりに NULL ポインターを渡すことができます。この方法の唯一の欠点は、パスワード保護された画像ファイルを ABBYY FineReader Engine で開けないことです。

<div id="method">
  ## メソッド
</div>

| 名前                                                                                                                  | 説明          |
| ------------------------------------------------------------------------------------------------------------------- | ----------- |
| [GetPassword](/ja/fine-reader/engine/api-reference/image-related-objects/iimagepasswordcallback/getpassword-method) | パスワードを返します。 |

<div id="input-parameter">
  ## 入力パラメーター
</div>

このオブジェクトは、次のメソッドの入力パラメーターとして渡されます。

* [Engine](/ja/fine-reader/engine/api-reference/engine-object-iengine-interface) オブジェクトの [OpenImageFileFromMemory](/ja/fine-reader/engine/api-reference/engine-object-iengine-interface/processing-methods/openimagefilefrommemory-method)、[RecognizeImageFile](/ja/fine-reader/engine/api-reference/engine-object-iengine-interface/processing-methods/recognizeimagefile-method)、[GetNumberOfPagesInImageFile](/ja/fine-reader/engine/api-reference/engine-object-iengine-interface/processing-methods/getnumberofpagesinimagefile-method)、[IsPdfPortfolio](/ja/fine-reader/engine/api-reference/engine-object-iengine-interface/processing-methods/ispdfportfolio-method)、[IsPdfPortfolioFromStream](/ja/fine-reader/engine/api-reference/engine-object-iengine-interface/processing-methods/ispdfportfoliofromstream-method)、[IsPdfWithTextualContent](/ja/fine-reader/engine/api-reference/engine-object-iengine-interface/processing-methods/ispdfwithtextualcontent-method)、[IsPdfWithTextualContentFromStream](/ja/fine-reader/engine/api-reference/engine-object-iengine-interface/processing-methods/ispdfwithtextualcontentfromstream-method)、[InjectTextLayer](/ja/fine-reader/engine/api-reference/engine-object-iengine-interface/processing-methods/injecttextlayer-method) メソッド
* [FRDocument](/ja/fine-reader/engine/api-reference/document-related-objects/frdocument) オブジェクトの [AddImageFileFromAttachment](/ja/fine-reader/engine/api-reference/document-related-objects/frdocument/addimagefilefromattachment-method) メソッドおよび [AddImageFileWithPasswordCallback](/ja/fine-reader/engine/api-reference/document-related-objects/frdocument/addimagefilewithpasswordcallback-method) メソッド

<div id="samples">
  ## サンプル
</div>

このインターフェイスは、次のコード サンプルで使用されます: [CommandLineInterface](/ja/fine-reader/engine/guided-tour/samples#commandlineinterface) (Windows および Linux) 。

<div id="remarks">
  ## 注記
</div>

Linux では、Engine オブジェクトがプロセス外サーバーとして読み込まれている場合、このインターフェイスは動作しません。