Função ImmGetIMEFileNameA (immdev.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 terminação. Para Unicode, uBufLen especifica o tamanho em caracteres Unicode, sem incluir o caractere nulo de terminação.

Valor retornado

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.

Comentários

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

Observação

O cabeçalho immdev.h define ImmGetIMEFileName como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho], suporte ao idioma do Leste Asiático instalado.
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	immdev.h (inclua Immdev.h, Windows.h)
Biblioteca	Imm32.lib
DLL	Imm32.dll

Confira também

Gerenciador de Métodos de Entrada

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