Função ImmGetCompositionStringA (immdev.h)
Recupera informações sobre a cadeia de caracteres de composição.
Sintaxe
LONG ImmGetCompositionStringA(
HIMC unnamedParam1,
DWORD unnamedParam2,
[out, optional] LPVOID lpBuf,
[in] DWORD dwBufLen
);
Parâmetros
unnamedParam1
unnamedParam2
[out, optional] lpBuf
Ponteiro para um buffer no qual a função recupera as informações da cadeia de caracteres de composição.
[in] dwBufLen
Tamanho, em bytes, do buffer de saída, mesmo que a saída seja uma cadeia de caracteres Unicode. O aplicativo define esse parâmetro como 0 se a função deve retornar o tamanho do buffer de saída necessário.
Valor de retorno
Retorna o número de bytes copiados para o buffer de saída. Se dwBufLen for definido como 0, a função retornará o tamanho do buffer, em bytes, necessário para receber todas as informações solicitadas, excluindo o caractere nulo de encerramento. O valor retornado é sempre o tamanho, em bytes, mesmo que os dados solicitados sejam uma cadeia de caracteres Unicode.
Essa função retornará um dos seguintes códigos de erro negativos se não tiver êxito:
- IMM_ERROR_NODATA. Os dados de composição não estão prontos no contexto de entrada.
- IMM_ERROR_GENERAL. Erro geral detectado pelo IME.
Observações
Um aplicativo chama essa função em resposta à mensagem WM_IME_COMPOSITION ou WM_IME_STARTCOMPOSITION. O IMM remove as informações quando o aplicativo chama a função ImmReleaseContext.
Nota
O cabeçalho immdev.h define ImmGetCompositionString como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.
Requisitos
Requisito | Valor |
---|---|
de cliente com suporte mínimo | Windows XP [somente aplicativos da área de trabalho], suporte à linguagem do Leste Asiático instalado. |
servidor com suporte mínimo | Windows Server 2003 [somente aplicativos da área de trabalho] |
da Plataforma de Destino |
Windows |
cabeçalho | immdev.h (inclua Immdev.h, Windows.h) |
biblioteca | Imm32.lib |
de DLL |
Imm32.dll |
Consulte também
ImmReleaseContext
do Gerenciador de Métodos de Entrada