Pular para o conteúdo principal
Esse método é implementado pelo usuário. O ABBYY FineReader Engine pode usar um ponteiro para a interface IImagePasswordCallback em métodos que abrem arquivos de imagem para solicitar senhas de arquivos protegidos, mais especificamente PDFs. Uma implementação típica desse método pode exibir uma caixa de diálogo na qual o usuário pode informar a senha necessária para acessar o arquivo de imagem.

​
Sintaxe

​
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

​
Parâmetros

OwnerNeeded [in] Este parâmetro indica se será solicitada a senha do usuário (OwnerNeeded=False) ou a senha do proprietário (OwnerNeeded=True) para o arquivo de imagem em formato PDF. A senha do proprietário fornece o nível mais alto de acesso ao conteúdo e às propriedades do documento. IsResultValid [in, out] Este parâmetro deve ser definido como TRUE se o valor retornado em Password deve ser usado pelo ABBYY FineReader Engine. Quando definido como FALSE, o ABBYY FineReader Engine agirá como se nenhuma senha estivesse disponível e não abrirá o arquivo de imagem. O valor padrão deste parâmetro é FALSE. Password [out, retval] Este parâmetro permite retornar a string a ser usada como senha para o arquivo de imagem.

​
Valores de retorno

Este método não possui valores de retorno específicos. Ele retorna os valores de retorno padrão das funções do ABBYY FineReader Engine.

​
Observações

Este método pode ser chamado pelo ABBYY FineReader Engine mais de uma vez, até que a senha correta seja fornecida ou o parâmetro isResultValid seja definido como FALSE, o que significa que o usuário não pode (ou não quer) inserir a senha.

​
Consulte também

IImagePasswordCallback