InternalGetWindowText

指定したウィンドウのタイトルバーテキスト(タイトルバーがある場合)をバッファにコピーする。

InternalGetWindowText hWnd, pString, cchMaxCount

hWnd : [intptr] 型: HWND テキストを含むウィンドウまたはコントロールへのハンドル。
pString : [wstr] 型: LPWSTR テキストを受け取るバッファ。文字列がバッファと同じかそれ以上の長さの場合、文字列は切り詰められて NULL 文字で終端される。
cchMaxCount : [int] 型: int NULL 文字を含め、バッファにコピーする最大文字数。テキストがこの制限を超える場合は切り詰められる。

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

解説

指定したウィンドウのタイトルバーテキスト(タイトルバーがある場合)をバッファにコピーする。

[戻り値]
型: int 関数が成功した場合、戻り値はコピーされた文字列の長さ(終端 NULL
を含まない文字数)である。ウィンドウにタイトルバーが無いか、テキストが無いか、タイトルバーが空、またはウィンドウ/コントロールハンドルが無効な場合、戻り値はゼロである。拡張エラー情報を取得するには
GetLastError を呼ぶ。

[備考]
この関数は Windows XP Service Pack 1 (SP1) および Windows Server 2003 まで SDK
のヘッダとインポートライブラリに含まれていなかった。該当ヘッダとインポートライブラリを持っていない場合、LoadLibrary と
GetProcAddress を使って関数を呼び出せる。

情報

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