SendIMEMessageExW-Funktion (ime.h)

Artikel
11/20/2024

[Diese Funktion ist veraltet und sollte nicht verwendet werden.]

Gibt eine Aktion oder Verarbeitung für den Eingabemethoden-Editor (INPUT Method Editor, IME) über eine angegebene Unterfunktion an.

Syntax

LRESULT SendIMEMessageExW(
       HWND   unnamedParam1,
       LPARAM unnamedParam2
);

Parameter

unnamedParam1

unnamedParam2

Rückgabewert

Das Ergebnis der Verarbeitung der Unterfunktion. Wenn das Ergebnis nicht erfolgreich ist, wird eine der folgenden Fehlercodes in der wParam- der IMESTRUCT Struktur gespeichert.

Rückgabecode	Beschreibung
IME_RS_DISKERROR	Diskettenfehler.
IME_RS_ERROR	Allgemeiner Fehler.
IME_RS_ILLEGAL	Enthält ein unzulässiges Zeichen.
IME_RS_INVALID	Ungültige Unterfunktion.
IME_RS_NEST	Die Unterfunktion ist geschachtelt und kann daher nicht verwendet werden.
IME_RS_NOIME	Der IME wurde nicht ausgewählt (wurde nicht installiert).
IME_RS_NOROOM	Kurz vor Ort.
IME_RS_NOTFOUND	Es wurde kein Kandidat gefunden.
IME_RS_SYSTEMMODAL	Windows befindet sich im Systemmodus, Daten können nicht an den IME übergeben werden.
IME_RS_TOOLONG	Zeichen zu lang.

Bemerkungen

SendIMEMessageEx garantiert die in den Spezifikationen festgelegte Aktion nur für IMEs, die die WM_CONVERTREQUESTEX Nachricht unterstützen. Für einen IME, der WM_CONVERTREQUESTEXnicht unterstützt, sendet SendIMEMessageEx eine WM_CONVERTREQUEST Nachricht an den IME und gibt den Inhalt des wParam- Members der IMESTRUCT Struktur zurück. Wenn die Verarbeitung der Unterfunktion nicht normal abgeschlossen wurde, werden diese Funktionen IME_RS_ERROR in wParam-festgelegt.

Anmerkung

Der Ime.h-Header definiert SendIMEMessageEx als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	ime.h (include Windows.h)
Library	User32.lib
DLL-	User32.dll

Freigeben über