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

Vedi anche

Gestione metodi di input

Funzioni di Gestione metodi di input