Funzione ImmGetGuideLineA (imm.h)
Recupera informazioni sugli errori. Le applicazioni usano le informazioni per le notifiche utente.
Sintassi
DWORD ImmGetGuideLineA(
[in] HIMC unnamedParam1,
[in] DWORD dwIndex,
[out, optional] LPSTR lpBuf,
[in] DWORD dwBufLen
);
Parametri
[in] unnamedParam1
Gestire 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, non incluso 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, la restituzione è 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 essere 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 o 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, alcuni vocali non possono essere messi insieme per formare un carattere. |
| GL_ID_TOOMANYSTROKE | Ci sono 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 dei caratteri di lettura dall'utente finale. |
| GL_ID_INPUTRADICAL | L'IME accetta l'input del carattere radicale dall'utente finale. |
| GL_ID_INPUTCODE | L'IME accetta l'input del codice di 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 è il numero di byte della stringa copiata nel buffer. Tuttavia, se dwBufLen è 0, il valore restituito è la dimensione del buffer necessaria per ricevere la stringa, non incluso 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 è il 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.
Commenti
Le applicazioni in genere chiamano 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 preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows XP [solo app desktop], supporto per la lingua asiatica orientale installato. |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | imm.h (include Immdev.h, Windows.h) |
| Libreria | Imm32.lib |
| DLL | Imm32.dll |