Funzione ImmGetIMEFileNameW (immdev.h)

Articolo
11/20/2024

Recupera il nome file dell'IME associato alle impostazioni locali di input specificate.

Sintassi

UINT ImmGetIMEFileNameW(
                  HKL    unnamedParam1,
  [out, optional] LPWSTR 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, non incluso 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 necessario 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 Null di terminazione Unicode.

Osservazioni

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 immdev.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 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	immdev.h (include Immdev.h, Windows.h)
libreria	Imm32.lib
dll	Imm32.dll

Vedere anche

di Gestione metodi di input

funzioni di Gestione metodi di input

Condividi tramite