Compartilhar via


Função GetBestResultString (recapis.h)

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 que você usa 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 .

Valor de retorno

Essa função pode retornar um desses valores.

Código de retorno Description
S_OK
Êxito.

Para reconhecedores latinos e asiáticos, isso resulta em combinação com uma cadeia de caracteres vazia em pwcBestResult significa que não existe nenhum resultado de reconhecimento.

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

Requirements

Requirement Value
Cliente mínimo suportado Windows XP Tablet PC Edition [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo compatível Nenhum compatível
da Plataforma de Destino Windows
Header recapis.h
Library inkobjcore.lib
de DLL inkobjcore.dll