ImmEnumRegisterWordA function (immdev.h)

Enumerates the register strings having the specified reading string, style, and register string.

Syntax

UINT ImmEnumRegisterWordA(
  [in]           HKL                   unnamedParam1,
  [in]           REGISTERWORDENUMPROCA unnamedParam2,
  [in, optional] LPCSTR                lpszReading,
  [in]           DWORD                 unnamedParam4,
  [in, optional] LPCSTR                lpszRegister,
  [in]           LPVOID                unnamedParam6
);

Parameters

[in] unnamedParam1

Input locale identifier.

[in] unnamedParam2

Pointer to the callback function. For more information, see EnumRegisterWordProc.

[in, optional] lpszReading

Pointer to the reading string to enumerate. The application sets this parameter to NULL if the function is to enumerate all available reading strings that match the dwStyle and lpszRegister settings.

[in] unnamedParam4

Style to enumerate. The application specifies 0 if the function is to enumerate all available styles that match the lpszReading and lpszRegister settings.

[in, optional] lpszRegister

Pointer to the register string to enumerate. The application sets this parameter to NULL if the function is to enumerate all register strings that match the lpszReading and dwStyle settings.

[in] unnamedParam6

Pointer to application-supplied data. The function passes this data to the callback function.

Return value

Returns the last value returned by the callback function, with the meaning defined by the application. The function returns 0 if it cannot enumerate the register strings.

Remarks

If dwStyle is set to 0 and both lpszReading and lpszRegister are set to NULL, this function enumerates all register strings in the IME dictionary.

Note

The immdev.h header defines ImmEnumRegisterWord as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only],East Asian language support installed.
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header immdev.h (include Immdev.h, Windows.h)
Library Imm32.lib
DLL Imm32.dll

See also

EnumRegisterWordProc

Input Method Manager

Input Method Manager Functions