CheckWords-Methode der IExternalDictionary-Schnittstelle

Diese Methode wird clientseitig implementiert. Sie wird während der Erkennung aufgerufen und empfängt eine Sammlung von Fuzzy-Strings. Die Anzahl der Fuzzy-Strings in der Sammlung kann je nach den erkannten Varianten des Worts variieren. Diese Methode übermittelt dem Recognizer mithilfe der Methode ExternalDictionaryResult des Objekts ExternalDictionaryCallback Informationen über die Strings in der Sammlung, die Wörterbuchwörter enthalten. Wenn die Methode ExternalDictionaryResult für einen Fuzzy-String nicht aufgerufen wird, geht der Recognizer davon aus, dass im Wörterbuch keine passenden Wörter gefunden wurden.

Syntax

C++

HRESULT CheckWords(
  IFuzzyStrings*               Request,
  IExternalDictionaryCallback* Callback
);

C#

void CheckWords(
  IFuzzyStrings                Request,
  IExternalDictionaryCallback Callback
);

Visual Basic .NET

Sub CheckWords( _
  Request As IFuzzyStrings, _
  Callback As IExternalDictionaryCallback _
)

Parameter

Request [in] Diese Variable verweist auf das FuzzyStrings-Objekt, das der Sammlung von Fuzzy-Strings entspricht. Callback [in] Diese Variable verweist auf das ExternalDictionaryCallback-Objekt. Der Recognizer erhält von diesem Objekt Informationen über Wörter aus dem Wörterbuch.

Rückgabewerte

[Nur in C++] Wenn diese Methode einen anderen Wert als S_OK zurückgibt, weist dies darauf hin, dass clientseitig ein Fehler aufgetreten ist.

Hinweise

Die Zeiger auf die Objekte FuzzyStrings und ExternalDictionaryCallback, die als die Parameter Request und Callback verwendet wurden, werden nach Abschluss der Ausführung der Methode CheckWords automatisch freigegeben. Daher müssen Sie in der Implementierung der Methode CheckWords die Methode Release für diese Objekte nicht aufrufen.
Die clientseitige Implementierung dieser Methode muss sicherstellen, dass alle innerhalb der Methode ausgelösten Ausnahmen abgefangen und behandelt werden und dass keine Ausnahmen aus der Methode nach außen weitergegeben werden. Die Weitergabe einer Ausnahme über die Methode hinaus kann zu unvorhersehbaren Ergebnissen führen (z. B. zur Beendigung des Programms).