Compartir a través de


Función GetBestResultString (recapis.h)

Recupera la mejor cadena de resultado.

Syntax

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

Parámetros

hrc

Controle el contexto del reconocedor.

pcSize

En la entrada, el número de caracteres que puede contener el búfer pwcBestResult . En la salida, el número de caracteres que contiene el búfer pwcBestResult . Si pwcBestResult es NULL, la función devuelve el tamaño necesario del búfer que se usa para asignar el búfer pwcBestResult .

pwcBestResult

Resultado del reconocimiento. Si el búfer es demasiado pequeño, la función trunca la cadena. La cadena no está terminada en NULL. Para determinar el tamaño necesario del búfer, establezca pwcBestResult en NULL; use pcSize para asignar el búfer pwcBestResult .

Valor devuelto

Esta función puede devolver uno de estos valores.

Código de retorno Description
S_OK
Éxito.

En el caso de los reconocedores latinos y asiáticos orientales, este resultado se combina con una cadena vacía en pwcBestResult , lo que significa que no existe ningún resultado de reconocimiento.

TPC_S_TRUNCATED
La cadena se trunca para caber en el búfer pwcBestResult .
E_POINTER
Uno de los parámetros es un puntero no válido.
E_FAIL
Error no especificado.
E_INVALIDARG
Se recibió un argumento no válido.
E_UNEXPECTED
Parámetro o tipo de propiedad inesperados.
TPC_E_NOT_RELEVANT
El contexto del reconocedor no contiene resultados.

Requisitos

Requirement Importancia
Cliente mínimo compatible Windows XP Tablet PC Edition [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo admitido No se admite ninguno
de la plataforma de destino de Windows
Header recapis.h
Library inkobjcore.lib
DLL de inkobjcore.dll