Funzione ImmGetGuideLineW (imm.h)
Recupera informazioni sugli errori. Le applicazioni usano le informazioni per le notifiche utente.
Sintassi
DWORD ImmGetGuideLineW(
[in] HIMC unnamedParam1,
[in] DWORD dwIndex,
[out, optional] LPWSTR lpBuf,
[in] DWORD dwBufLen
);
Parametri
[in] unnamedParam1
Handle nel contesto di input.
[in] dwIndex
Tipo di informazioni sulle linee guida da recuperare. Questo parametro può avere uno dei valori seguenti.
[out, optional] lpBuf
Puntatore a un buffer in cui la funzione recupera la stringa del messaggio di errore. Questo parametro contiene NULL se dwIndex non è GGL_STRING o GGL_PRIVATE o se dwBufLen è impostato su 0.
[in] dwBufLen
Dimensioni, in byte, del buffer di output. L'applicazione imposta questo parametro su 0 se la funzione restituisce le dimensioni del buffer necessarie per ricevere la stringa del messaggio di errore, senza includere il carattere Null di terminazione.
Valore restituito
Restituisce un livello di errore, un indice di errore o la dimensione di una stringa di messaggio di errore, a seconda del valore del parametro dwIndex. Se dwIndex è GGL_LEVEL, il valore restituito è uno dei valori seguenti.
| Valore | Significato |
|---|---|
| GL_LEVEL_ERROR | Errore. L'IME potrebbe non essere in grado di continuare. |
| GL_LEVEL_FATAL | Errore irreversibile. L'IME non può continuare e i dati potrebbero andare persi. |
| GL_LEVEL_INFORMATION | Nessun errore. Le informazioni sono disponibili per l'utente. |
| GL_LEVEL_NOGUIDELINE | Nessun errore. Rimuovere il messaggio di errore precedente, se ancora visibile. |
| GL_LEVEL_WARNING | Input imprevisto o altro risultato. L'utente deve essere avvisato, ma l'IME può continuare. |
Se dwIndex è GGL_INDEX, il valore restituito è uno dei valori seguenti.
| Valore | Significato |
|---|---|
| GL_ID_CANNOTSAVE | Impossibile salvare il dizionario o i dati delle statistiche. |
| GL_ID_NOCONVERT | L'IME non può più convertire. |
| GL_ID_NODICTIONARY | L'IME non riesce a trovare il dizionario oppure il dizionario ha un formato imprevisto. |
| GL_ID_NOMODULE | L'IME non riesce a trovare il modulo necessario. |
| GL_ID_READINGCONFLICT | Si è verificato un conflitto di lettura. Ad esempio, alcune vocali non possono essere unite per formare un carattere. |
| GL_ID_TOOMANYSTROKE | Sono presenti troppi tratti per un carattere o una clausola. |
| GL_ID_TYPINGERROR | Errore di digitazione. L'IME non può gestire questa digitazione. |
| GL_ID_UNKNOWN | Errore sconosciuto. Fare riferimento alla stringa del messaggio di errore. |
| GL_ID_INPUTREADING | L'IME accetta l'input di caratteri di lettura dall'utente finale. |
| GL_ID_INPUTRADICAL | L'IME accetta l'input di caratteri radicale dell'utente finale. |
| GL_ID_INPUTCODE | L'IME accetta l'input del codice carattere dall'utente finale. |
| GL_ID_CHOOSECANDIDATE | L'IME accetta la selezione di stringhe candidate dall'utente finale. |
| GL_ID_REVERSECONVERSION | Le informazioni sulla conversione inversa sono disponibili chiamando ImmGetGuideLine, specificando GGL_PRIVATE. Le informazioni recuperate sono in formato CANDIDATELIST. |
Se dwIndex è GGL_STRING, il valore restituito corrisponde al numero di byte della stringa copiata nel buffer. Tuttavia, se dwBufLen è 0, il valore restituito è la dimensione del buffer necessaria per ricevere la stringa, senza includere il carattere Null di terminazione. Per Unicode, se dwBufLen è 0, il valore restituito è la dimensione, in byte non incluso il carattere Null di terminazione Unicode.
Se dwIndex è GGL_PRIVATE, il valore restituito corrisponde al numero di byte di informazioni copiate nel buffer. Se dwIndex è GGL_PRIVATE e dwBufLen è 0, il valore restituito è la dimensione del buffer necessaria per ricevere le informazioni.
Osservazioni
Le applicazioni chiamano in genere questa funzione dopo aver ricevuto un comando IMN_GUIDELINE.
Nota
L'intestazione imm.h definisce ImmGetGuideLine 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 XP [solo app desktop],è installato il supporto per la lingua dell'Asia orientale. |
| server minimo supportato | Windows Server 2003 [solo app desktop] |
| piattaforma di destinazione | Finestre |
| intestazione |
imm.h (include Immdev.h, Windows.h) |
| libreria |
Imm32.lib |
| dll | Imm32.dll |