Função ImmGetIMEFileNameA (imm.h)

Recupera o nome do arquivo do IME associado à localidade de entrada especificada.

Sintaxe

UINT ImmGetIMEFileNameA(
                  HKL   unnamedParam1,
  [out, optional] LPSTR lpszFileName,
  [in]            UINT  uBufLen
);

Parâmetros

unnamedParam1

[out, optional] lpszFileName

Ponteiro para um buffer no qual a função recupera o nome do arquivo. Esse parâmetro contém NULL quando uBufLen é definido como NULL.

[in] uBufLen

Tamanho, em bytes, do buffer de saída. O aplicativo especifica 0 se a função deve retornar o tamanho do buffer necessário para receber o nome do arquivo, não incluindo o caractere nulo de encerramento. Para Unicode, uBufLen especifica o tamanho em caracteres Unicode, não incluindo o caractere nulo de terminação.

Valor de retorno

Retorna o número de bytes no nome do arquivo copiado para o buffer de saída. Se o aplicativo definir uBufLen como 0, a função retornará o tamanho do buffer necessário para o nome do arquivo. Em ambos os casos, o caractere nulo de terminação não está incluído.

Para Unicode, a função retorna o número de caracteres Unicode copiados para o buffer de saída, sem incluir o caractere nulo de terminação Unicode.

Observações

No registro, o sistema operacional armazena o nome do arquivo como o "valor do nome do IME" na chave do Registro HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\Keyboard Layouts\HKL.

Requisitos

Consulte também

do Gerenciador de Métodos de Entrada

Funções do Gerenciador de Métodos de Entrada