Condividi tramite


Funzione SendIMEMessageExA (ime.h)

[Questa funzione è obsoleta e non deve essere usata.]

Specifica un'azione o un'elaborazione per Input Method Editor (IME) tramite una sottofunzione specificata.

Sintassi

LRESULT SendIMEMessageExA(
       HWND   unnamedParam1,
       LPARAM unnamedParam2
);

Parametri

unnamedParam1

unnamedParam2

Valore restituito

Risultato dell'elaborazione della sottofunzione. Se il risultato non riesce, uno dei codici di errore seguenti viene archiviato nel wParam della struttura IMESTRUCT .

Codice restituito Descrizione
IME_RS_DISKERROR
Errore del disco.
IME_RS_ERROR
Errore generale.
IME_RS_ILLEGAL
Contiene un carattere non valido.
IME_RS_INVALID
Sottofunzione non valida.
IME_RS_NEST
La sottofunzione è annidata e pertanto non può essere usata.
IME_RS_NOIME
L'IME non è stato selezionato (non è stato installato).
IME_RS_NOROOM
Breve area.
IME_RS_NOTFOUND
Nessun candidato trovato.
IME_RS_SYSTEMMODAL
Windows è in modalità di sistema, i dati non possono essere passati all'IME.
IME_RS_TOOLONG
Caratteri troppo lunghi.

Osservazioni

SendIMEMessageEx garantisce l'azione stabilita nelle specifiche solo per gli IMEs che supportano il messaggio WM_CONVERTREQUESTEX. Per un IME che non supporta WM_CONVERTREQUESTEX, SendIMEMessageEx invia un messaggio di WM_CONVERTREQUEST all'IME e restituisce il contenuto del wParam membro della struttura IMESTRUCT. Se l'elaborazione della sottofunzione non è stata completata normalmente, queste funzioni impostano IME_RS_ERROR in wParam.

Nota

L'intestazione ime.h definisce SendIMEMessageEx come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito Valore
client minimo supportato Windows 2000 Professional [solo app desktop]
server minimo supportato Windows 2000 Server [solo app desktop]
piattaforma di destinazione Finestre
intestazione ime.h (include Windows.h)
libreria User32.lib
dll User32.dll