Compartilhar via

Função GetBestResultString (recapis.h)

  • Artigo

Recupera a melhor cadeia de caracteres de resultado.

Sintaxe

HRESULT GetBestResultString(
  HRECOCONTEXT hrc,
  ULONG        *pcSize,
  WCHAR        *pwcBestResult
);

Parâmetros

hrc

Manipule para o contexto do reconhecedor.

pcSize

Na entrada, o número de caracteres que o buffer pwcBestResult pode conter. Na saída, o número de caracteres que o buffer pwcBestResult contém. Se pwcBestResult for NULL, a função retornará o tamanho necessário do buffer usado para alocar o buffer pwcBestResult .

pwcBestResult

Resultado do reconhecimento. Se o buffer for muito pequeno, a função truncará a cadeia de caracteres. A cadeia de caracteres não é terminada em NULL. Para determinar o tamanho necessário do buffer, defina pwcBestResult como NULL; use pcSize para alocar o buffer pwcBestResult .

Retornar valor

Essa função pode retornar um desses valores.

Código de retorno Descrição
S_OK
 Êxito.

Para reconhecedores latinos e asiáticos, isso resulta em combinação com uma cadeia de caracteres vazia em pwcBestResult significa que nenhum resultado de reconhecimento existe.
TPC_S_TRUNCATED
 A cadeia de caracteres é truncada para caber no buffer pwcBestResult .
E_POINTER
 Um dos parâmetros é um ponteiro inválido.
E_FAIL
 Ocorreu um erro não especificado.
E_INVALIDARG
 Um argumento inválido foi recebido.
E_UNEXPECTED
 Parâmetro inesperado ou tipo de propriedade.
TPC_E_NOT_RELEVANT
 O contexto do reconhecedor não contém resultados.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP Tablet PC Edition [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Nenhum compatível
Plataforma de Destino Windows
Cabeçalho recapis.h
DLL inkobjcore.dll