Skip to content

Latest commit

 

History

History
88 lines (67 loc) · 3.51 KB

nf-imm-immgetdescriptionw.md

File metadata and controls

88 lines (67 loc) · 3.51 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:imm.ImmGetDescriptionW
ImmGetDescriptionW function (imm.h)
The ImmGetDescriptionW (Unicode) function (imm.h) copies the description of the IME to the specified buffer.
ImmGetDescription
ImmGetDescription function [Internationalization for Windows Applications]
ImmGetDescriptionW
_win32_ImmGetDescription
imm/ImmGetDescription
imm/ImmGetDescriptionW
intl.immgetdescription
intl\immgetdescription.htm
Intl
62f4efc8-7b46-4d8e-a6a2-2f346efe8ba6
08/04/2022
ImmGetDescription, ImmGetDescription function [Internationalization for Windows Applications], ImmGetDescriptionA, ImmGetDescriptionW, _win32_ImmGetDescription, imm/ImmGetDescription, imm/ImmGetDescriptionA, imm/ImmGetDescriptionW, intl.immgetdescription
imm.h
Immdev.h, Windows.h
Windows
Windows XP [desktop apps only],East Asian language support installed., East Asian language support installed.
Windows Server 2003 [desktop apps only]
ImmGetDescriptionW (Unicode) and ImmGetDescriptionA (ANSI)
Imm32.lib
Imm32.dll
Windows
19H1
ImmGetDescriptionW
imm/ImmGetDescriptionW
c++
APIRef
kbSyntax
DllExport
Imm32.dll
ImmGetDescription
ImmGetDescriptionA
ImmGetDescriptionW

ImmGetDescriptionW function

-description

Copies the description of the IME to the specified buffer.

-parameters

-param HKL [in]

Input locale identifier.

-param lpszDescription [out, optional]

Pointer to a buffer in which the function retrieves the null-terminated string describing the IME.

-param uBufLen [in]

Size, in characters, of the output buffer. The application sets this parameter to 0 if the function is to return the buffer size needed for the complete description, excluding the terminating null character.

Windows NT, Windows 2000, Windows XP: The size of the buffer is in Unicode characters, each consisting of two bytes. If the parameter is set to 0, the function returns the size of the buffer required in Unicode characters, excluding the Unicode terminating null character.

-returns

Returns the number of characters copied to the output buffer. If the application sets the uBufLen parameter to 0, the function returns the size of the buffer required to receive the description. Neither value includes the terminating null character. For Unicode, the function returns the number of Unicode characters, not including the Unicode terminating null character.

-see-also

Input Method Manager

Input Method Manager Functions

-remarks

Note

The imm.h header defines ImmGetDescription 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.