> ## 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.

# GetPassword-Methode der IImagePasswordCallback-Schnittstelle

> GetPassword-Methode der IImagePasswordCallback-Schnittstelle in der ABBYY FineReader Engine API — clientseitige Methode, die beim Öffnen einer kennwortgeschützten Bilddatei ein Kennwort an FineReader Engine zurückgibt; zeigt dem Benutzer in der Regel ein Dialogfeld an.

Diese Methode wird vom Benutzer implementiert. ABBYY FineReader Engine kann in Methoden, die Bilddateien öffnen, einen Zeiger auf die [IImagePasswordCallback](/de/fine-reader/engine/api-reference/image-related-objects/iimagepasswordcallback)-Schnittstelle verwenden, um Kennwörter für geschützte Dateien anzufordern, genauer gesagt für PDFs. Eine typische Implementierung dieser Methode könnte ein Dialogfeld anzeigen, in dem der Benutzer das zum Zugriff auf die Bilddatei erforderliche Kennwort eingeben kann.

<div id="syntax">
  ## Syntax
</div>

<div id="c">
  ### C++
</div>

```cpp theme={null}
HRESULT raw_GetPassword(
  VARIANT_BOOL  OwnerNeeded,
  VARIANT_BOOL* IsResultValid,
  BSTR*         Password
);
```

### C\#

```csharp theme={null}
string GetPassword(
  bool     OwnerNeeded,
  ref bool IsResultValid
);
```

<div id="visual-basic-net">
  ### Visual Basic .NET
</div>

```vb theme={null}
Function IImagePasswordCallback_GetPassword( _
  OwnerNeeded As Boolean, _
  ByRef IsResultValid As Boolean _
) As String
```

<div id="parameters">
  ## Parameter
</div>

OwnerNeeded

\[in] Dieser Parameter gibt an, ob für die Bilddatei im PDF-Format das Benutzerkennwort (OwnerNeeded=False) oder das Besitzerkennwort (OwnerNeeded=True) angefordert wird. Das Besitzerkennwort gewährt die höchste Zugriffsstufe auf den Inhalt und die Eigenschaften des Dokuments.

IsResultValid

\[in, out] Dieser Parameter sollte auf TRUE gesetzt werden, wenn der in Password enthaltene Ergebniswert von ABBYY FineReader Engine verwendet werden soll. Ist er auf FALSE gesetzt, verhält sich ABBYY FineReader Engine so, als wäre kein Kennwort verfügbar, und öffnet die Bilddatei nicht. Der Standardwert dieses Parameters ist FALSE.

Password

\[out, retval] Dieser Parameter ermöglicht es Ihnen, den string zurückzugeben, der als Kennwort für die Bilddatei verwendet werden soll.

<div id="return-values">
  ## Rückgabewerte
</div>

Diese Methode hat keine spezifischen Rückgabewerte. Sie gibt die [Standardrückgabewerte der Funktionen von ABBYY FineReader Engine](/de/fine-reader/engine/api-reference/return-codes) zurück.

<div id="remarks">
  ## Hinweise
</div>

Diese Methode kann von ABBYY FineReader Engine unter Umständen mehrmals aufgerufen werden, bis das richtige Kennwort zurückgegeben wird oder der Parameter isResultValid auf FALSE gesetzt wird. Das bedeutet, dass der Benutzer das Kennwort nicht eingeben kann (oder nicht eingeben möchte).

<div id="see-also">
  ## Siehe auch
</div>

[IImagePasswordCallback](/de/fine-reader/engine/api-reference/image-related-objects/iimagepasswordcallback)