Passer au contenu principal
Cette méthode est implémentée par l’utilisateur. ABBYY FineReader Engine peut utiliser un pointeur vers l’interface IImagePasswordCallback dans les méthodes qui ouvrent des fichiers image pour demander les mots de passe de fichiers protégés, en l’occurrence des PDF. Une implémentation typique de cette méthode peut afficher une boîte de dialogue dans laquelle l’utilisateur saisit le mot de passe nécessaire pour accéder au fichier image.

​
Syntaxe

​
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

​
Paramètres

OwnerNeeded [in] Ce paramètre indique si le mot de passe utilisateur (OwnerNeeded=False) ou le mot de passe propriétaire (OwnerNeeded=True) est requis pour le fichier image au format PDF. Le mot de passe propriétaire fournit le niveau d’accès le plus élevé au contenu et aux propriétés du document. IsResultValid [in, out] Ce paramètre doit être défini sur TRUE si la valeur de résultat de Password doit être utilisée par ABBYY FineReader Engine. Lorsqu’il est défini sur FALSE, ABBYY FineReader Engine se comportera comme si aucun mot de passe n’était disponible et n’ouvrira pas le fichier image. La valeur par défaut de ce paramètre est FALSE. Password [out, retval] Ce paramètre permet de renvoyer la string à utiliser comme mot de passe pour le fichier image.

​
Valeurs de retour

Cette méthode n’a pas de valeur de retour spécifique. Elle renvoie les valeurs de retour standard des fonctions d’ABBYY FineReader Engine.

​
Remarques

Cette méthode peut être appelée par ABBYY FineReader Engine, éventuellement à plusieurs reprises, jusqu’à ce que le mot de passe correct soit renvoyé ou que le paramètre isResultValid soit défini sur FALSE, ce qui signifie que l’utilisateur ne peut pas (ou ne souhaite pas) saisir le mot de passe.

​
Voir aussi

IImagePasswordCallback