IAgentNotifySinkEx::ListeningState
[Microsoft Agent ist ab Version Windows 7 veraltet und in nachfolgenden Versionen von Windows.]
HRESULT ListeningState(
long dwCharacterID, // character ID
long bListening, // listening mode state
long dwCause // cause
);
Benachrichtigt eine Clientanwendung, wenn sich der Abhörmodus ändert.
- Kein Rückgabewert.
-
dwCharacterID
-
Das Zeichen, für das sich der Lauschenzustand geändert hat.
-
bListening
-
Der Status des Lauschenmodus. True gibt an, dass der Lauschenmodus gestartet wurde. False, dass der Abhörmodus beendet wurde.
-
dwCause
-
Die Ursache für das Ereignis. Dies kann einer der folgenden Werte sein.
Wert BESCHREIBUNG const unsigned long LSCOMPLETE _ CAUSE _ PROGRAMDISABLED = 1; Der Lauschenmodus wurde durch Programmcode deaktiviert. const unsigned long LSCOMPLETE _ CAUSE _ PROGRAMTIMEDOUT = 2; Time out des Lauschenmodus (durch Programmcode aktiviert). const unsigned long LSCOMPLETE _ CAUSE _ USERTIMEDOUT = 3; Beim Lauschenmodus (aktiviert durch die Abhörtaste) ist ein Time out erfolgt. const unsigned long LSCOMPLETE _ CAUSE _ USERRELEASEDKEY = 4; Der Lauschenmodus wurde deaktiviert, da der Benutzer die Abhörtaste losgelassen hat. const unsigned long LSCOMPLETE _ CAUSE _ USERUTTERANCEENDED = 5; Der Lauschenmodus wurde deaktiviert, weil der Benutzer das Sprechen beendet hat. const unsigned long LSCOMPLETE _ CAUSE _ CLIENTDEACTIVATED = 6; Der Lauschenmodus wurde deaktiviert, weil der aktive Eingabeclient deaktiviert wurde. const unsigned long LSCOMPLETE _ CAUSE _ DEFAULTCHARCHANGE = 7 Der Lauschenmodus wurde deaktiviert, weil das Standardzeichen geändert wurde. const unsigned long LSCOMPLETE _ CAUSE _ USERDISABLED = 8 Der Lauschenmodus wurde deaktiviert, da der Benutzer die Spracheingabe deaktiviert hat.
Dieses Ereignis wird an alle Clients gesendet, wenn der Lauschmodus beginnt, nachdem der Benutzer die Abhörtaste drückt oder das Time out endet, oder wenn der eingabeaktive Client die IAgentCharacterEx::Listen-Methode mit True oder False aufruft.
Das Ereignis gibt Werte an die Clients zurück, auf denen dieses Zeichen derzeit geladen ist. Alle anderen Clients erhalten ein NULL-Zeichen (leere Zeichenfolge).