Funzione ImmGetDescriptionA (imm.h)
Copia la descrizione dell'IME nel buffer specificato.
Sintassi
UINT ImmGetDescriptionA(
HKL unnamedParam1,
[out, optional] LPSTR lpszDescription,
[in] UINT uBufLen
);
Parametri
unnamedParam1
[out, optional] lpszDescription
Puntatore a un buffer in cui la funzione recupera la stringa con terminazione Null che descrive l'IME.
[in] uBufLen
Dimensioni, in caratteri, del buffer di output. L'applicazione imposta questo parametro su 0 se la funzione restituisce le dimensioni del buffer necessarie per la descrizione completa, escluso il carattere Null di terminazione.
Windows NT, Windows 2000, Windows XP: Le dimensioni del buffer sono in caratteri Unicode, ognuna costituita da due byte. Se il parametro è impostato su 0, la funzione restituisce le dimensioni del buffer richieste nei caratteri Unicode, escluso il carattere Null di terminazione Unicode.
Valore restituito
Restituisce il numero di caratteri copiati nel buffer di output. Se l'applicazione imposta il parametro uBufLen su 0, la funzione restituisce le dimensioni del buffer necessarie per ricevere la descrizione. Nessuno dei due valori include il carattere null di terminazione. Per Unicode, la funzione restituisce il numero di caratteri Unicode, senza includere il carattere di terminazione Unicode null.
Commenti
Nota
L'intestazione imm.h definisce ImmGetDescription 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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.
Requisiti
| Client minimo supportato | Windows XP [solo app desktop],supporto per la lingua asiatica installata., supporto per la lingua dell'Asia 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 |