ImmGetCompositionStringW

ImmGetCompositionStringW (Unicode) 関数 (immdev.h) は組み立て中文字列の情報を取得する。

ImmGetCompositionStringW param0, param1, lpBuf, dwBufLen

param0 : [intptr] 
param1 : [int] 
lpBuf : [intptr] 組み立て中文字列情報を受け取るバッファへのポインタ。
dwBufLen : [int] 出力バッファのサイズ(バイト単位)。Unicode 文字列の場合もバイト単位。0 を渡すと必要サイズを返す。

(プラグイン / モジュール : imm32.dll)

解説

ImmGetCompositionStringW (Unicode) 関数 (immdev.h) は組み立て中文字列の情報を取得する。

[戻り値]
出力バッファにコピーされたバイト数を返す。dwBufLen が 0 の場合、終端 NULL
を除いた必要バッファサイズをバイト単位で返す。戻り値は要求情報が Unicode
文字列でも常にバイト単位。失敗時は以下の負のエラーコードのいずれかを返す:
(以下省略)

[備考]
WM_IME_COMPOSITION または WM_IME_STARTCOMPOSITION
メッセージへの応答として呼び出す。ImmReleaseContext を呼ぶと IMM は情報を除去する。注意: SIP
と併用される場合は全角ひらがなと半角カタカナの両方を扱うコードが必要。
> [!NOTE] > immdev.h は UNICODE マクロに応じて ImmGetCompositionString を
ANSI/Unicode 版のエイリアスとして定義する。

情報

プラグイン / モジュールimm32.dll
バージョン1.0
作成日2026/04/16
著作者IronHSP / CsWin32 bridge
URLhttps://github.com/inovia/IronHSP
備考Win32 API の imm32.dll 関数群。CsWin32 + win32metadata から自動生成。
hsp3net 専用 (intptr / NSTRUCT / wstr を使用)。
タイプ拡張命令
グループWin32API
対応環境
  • Windows 版 HSP
hs ファイルhsphelp\win32_imm32_gen2.hs