Funzione ImmGetIMEFileNameA (imm.h)
Recupera il nome file dell'IME associato alle impostazioni locali di input specificate.
Sintassi
UINT ImmGetIMEFileNameA(
HKL unnamedParam1,
[out, optional] LPSTR lpszFileName,
[in] UINT uBufLen
);
Parametri
unnamedParam1
[out, optional] lpszFileName
Puntatore a un buffer in cui la funzione recupera il nome del file. Questo parametro contiene NULL quando uBufLen è impostato su NULL.
[in] uBufLen
Dimensioni, in byte, del buffer di output. L'applicazione specifica 0 se la funzione deve restituire le dimensioni del buffer necessarie per ricevere il nome del file, senza includere il carattere null di terminazione. Per Unicode , uBufLen specifica le dimensioni in caratteri Unicode, senza includere il carattere Null di terminazione.
Valore restituito
Restituisce il numero di byte nel nome del file copiato nel buffer di output. Se l'applicazione imposta uBufLen su 0, la funzione restituisce le dimensioni del buffer necessarie per il nome del file. In entrambi i casi, il carattere null di terminazione non è incluso.
Per Unicode, la funzione restituisce il numero di caratteri Unicode copiati nel buffer di output, senza includere il carattere di terminazione Unicode null.
Commenti
Nel Registro di sistema, il sistema operativo archivia il nome file come "valore del nome IME" nella chiave del Registro di sistema HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\Keyboard Layouts\HKL.
Nota
L'intestazione imm.h definisce ImmGetIMEFileName 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 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 |