Vai al contenuto principale
Questo metodo viene implementato dall’utente. ABBYY FineReader Engine può utilizzare un puntatore all’interfaccia IImagePasswordCallback nei metodi che aprono file immagine per richiedere la password dei file protetti, in pratica file PDF. Un’implementazione tipica di questo metodo può visualizzare una finestra di dialogo in cui l’utente inserisce la password necessaria per accedere al file immagine.

​
Sintassi

​
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

​
Parametri

OwnerNeeded [in] Questo parametro indica se per il file immagine in formato PDF è richiesta la password utente (OwnerNeeded=False) oppure la password proprietario (OwnerNeeded=True). La password proprietario fornisce il livello di accesso più elevato al contenuto e alle proprietà del documento. IsResultValid [in, out] Questo parametro deve essere impostato su TRUE se il valore del risultato in Password deve essere utilizzato da ABBYY FineReader Engine. Quando è impostato su FALSE, ABBYY FineReader Engine si comporta come se non fosse disponibile alcuna password e non aprirà il file immagine. Il valore predefinito di questo parametro è FALSE. Password [out, retval] Questo parametro consente di restituire la string da utilizzare come password per il file immagine.

​
Valori di ritorno

Questo metodo non restituisce valori di ritorno specifici. Restituisce i valori di ritorno standard delle funzioni di ABBYY FineReader Engine.

​
Note

Questo metodo può essere richiamato da ABBYY FineReader Engine anche più di una volta, finché non viene fornita la password corretta oppure il parametro isResultValid viene impostato su FALSE, il che significa che l’utente non può (o non desidera) inserire la password.

​
Vedi anche

IImagePasswordCallback