Compartir a través de

Función GetBestResultString (recapis.h)

  • Artículo

Recupera la mejor cadena de resultado.

Sintaxis

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

Parámetros

hrc

Identificador del 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 termina 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 devuelto Descripción
S_OK
 Correcto.

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
 Se ha producido un error no especificado.
E_INVALIDARG
 Se recibió un argumento no válido.
E_UNEXPECTED
 Tipo de propiedad o parámetro inesperado.
TPC_E_NOT_RELEVANT
 El contexto del reconocedor no contiene resultados.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP Tablet PC Edition [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible No se admite ninguno
Plataforma de destino Windows
Encabezado recapis.h
Archivo DLL inkobjcore.dll