Compartir a través de

Método IInkLineInfo::GetCandidate (msinkaut.h)

  • Artículo

Devuelve una alternativa de reconocimiento de la lista de resultados de reconocimiento.

Sintaxis

HRESULT GetCandidate(
  [in]  UINT   nCandidateNum,
  [out] LPWSTR pwcRecogWord,
  [out] UINT   *pcwcRecogWord,
  [in]  DWORD  dwFlags
);

Parámetros

[in] nCandidateNum

Índice de base cero de la entrada de lista alternativa que se va a recuperar.

[out] pwcRecogWord

Búfer en el que se va a almacenar la alternativa de reconocimiento seleccionada. Si pwcRecogWord es NULL, el método no intenta recuperar la palabra alternativa de reconocimiento.

[out] pcwcRecogWord

Pasa la longitud del búfer pwcRecogWord en caracteres Unicode y devuelve el número de caracteres Unicode que se copiaron en el búfer.

[in] dwFlags

No se usa.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto Descripción
S_OK
 El método se ha llevado a cabo de forma correcta.
E_FAIL
 El índice nCandidateNum es mayor que el número de alternativas de reconocimiento.
ERROR_MORE_DATA
 El búfer pwcRecogWord no es lo suficientemente grande como para aceptar la alternativa de reconocimiento.

Comentarios

Si el parámetro pwcRecogWord es null, el método no intenta recuperar la palabra alternativa de reconocimiento, sino que solo establece pwcRecogWord en el número de caracteres del reconocimiento alternativo.

Si el búfer pwcRecogWord no es lo suficientemente grande como para contener la alternativa de reconocimiento, el búfer pwcRecogWord se rellena con el primer número de caracteres pwcRecogWord de la alternativa de reconocimiento.

Requisitos

   
Cliente mínimo compatible Windows XP Tablet PC Edition [solo aplicaciones de escritorio]
Servidor mínimo compatible No se admite ninguno
Plataforma de destino Windows
Encabezado msinkaut.h
Library InkObj.dll

Consulte también

IInkLineInfo

SetCandidate (método)