Freigeben über

GetBestResultString-Funktion (recapis.h)

  • Artikel

Ruft die beste Ergebniszeichenfolge ab.

Syntax

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

Parameter

hrc

Handle für den Erkennungskontext.

pcSize

Bei der Eingabe die Anzahl der Zeichen, die der pwcBestResult-Puffer enthalten kann. Bei der Ausgabe die Anzahl der Zeichen, die der pwcBestResult-Puffer enthält. Wenn pwcBestResultNULL ist, gibt die Funktion die erforderliche Größe des Puffers zurück, den Sie zum Zuordnen des pwcBestResult-Puffers verwenden.

pwcBestResult

Erkennungsergebnis. Wenn der Puffer zu klein ist, schneidet die Funktion die Zeichenfolge ab. Die Zeichenfolge ist nicht NULL-beendet. Legen Sie pwcBestResult auf NULL fest, um die erforderliche Größe des Puffers zu bestimmen. verwenden Sie pcSize , um den pwcBestResult-Puffer zuzuweisen.

Rückgabewert

Diese Funktion kann einen dieser Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
 Erfolg.

Bei lateinischen und ostasiatischen Erkennungen bedeutet dieses Ergebnis in Kombination mit einer leeren Zeichenfolge in pwcBestResult , dass kein Erkennungsergebnis vorhanden ist.
TPC_S_TRUNCATED
 Die Zeichenfolge wird abgeschnitten, um in den pwcBestResult-Puffer einzupassen.
E_POINTER
 Einer der Parameter ist ein ungültiger Zeiger.
E_FAIL
 Es ist ein unbekannter Fehler aufgetreten.
E_INVALIDARG
 Ein ungültiges Argument wurde empfangen.
E_UNEXPECTED
 Unerwarteter Parameter oder Eigenschaftstyp.
TPC_E_NOT_RELEVANT
 Der Erkennungskontext enthält keine Ergebnisse.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP Tablet PC Edition [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Nicht unterstützt
Zielplattform Windows
Kopfzeile recapis.h
DLL inkobjcore.dll