呼び出し側プロセスが指定したメモリ範囲に対して書き込みアクセス権を持つかを検証する。
IsBadWritePtr lp, ucb
lp : [intptr] メモリ ブロックの先頭バイトへのポインタ。 ucb : [int] メモリ ブロックのサイズ(バイト単位)。このパラメータが 0 の場合、戻り値は 0 となる。
(プラグイン / モジュール : kernel32.dll)
呼び出し側プロセスが指定したメモリ範囲に対して書き込みアクセス権を持つかを検証する。 [戻り値] 呼び出し側プロセスが指定メモリ範囲のすべてのバイトに対して書き込みアクセス権を持つ場合、戻り値は 0 となる。持たない場合、戻り値は 0 以外となる。デバッガ下で実行されており指定メモリ範囲のすべてのバイトに対して書き込みアクセス権を持たない場合、関数は first chance の STATUS_ACCESS_VIOLATION 例外を発生させる。この条件でブレークするようデバッガを設定できる。デバッガ内でプロセスの実行を再開すると、関数は通常どおり続行し 0 以外の値を返す。これはデバッグ支援として意図された動作である。 [備考] この関数は通常、サードパーティ ライブラリから返されたポインタを扱うときに使われる。サードパーティ DLL のメモリ管理動作を判断できない場合である。プロセス内のスレッドは互いに協調し、一方が他方の必要とするメモリを解放しないようにすることが期待される。この関数の使用はその必要性を排除しない。これを行わないとアプリケーションは予測不能な形で失敗することがある。無効である可能性のあるポインタの参照解決は、他のスレッドのスタック拡張を無効にしてしまう可能性がある。スタック拡張が無効化された状態でスレッドがスタックを使い切ると、親プロセスはポップアップ エラー ウィンドウや診断情報を出さずに直ちに終了する。呼び出し側プロセスが指定メモリ範囲の一部バイトに対してのみ書き込みアクセス権を持つ場合、戻り値は 0 以外となる。プリエンプティブ マルチタスク環境では、検査中のメモリに対するプロセスのアクセス権を他のスレッドが変更する可能性がある。たとえ関数が書き込みアクセスありと報告してもメモリへアクセスする際は構造化例外処理を使うべきである。構造化例外処理を使えば、アクセス違反例外が発生した際にシステムからプロセスに通知され、プロセスは例外を処理する機会を得られる。IsBadWritePtr はマルチスレッド セーフではない。複数のスレッドが共有するポインタに対して正しく使うには、検査中のメモリへアクセスするスレッドが 1 つだけになるクリティカル リージョン内で呼ぶ必要がある。クリティカル リージョンを作るにはクリティカルセクションやミューテックスなどの OS レベルのオブジェクト、あるいはインターロック関数を使う。
| プラグイン / モジュール | kernel32.dll |
| バージョン | 1.0 |
| 作成日 | 2026/04/16 |
| 著作者 | IronHSP / CsWin32 bridge |
| URL | https://github.com/inovia/IronHSP |
| 備考 | Win32 API の kernel32.dll 関数群。CsWin32 + win32metadata から自動生成。
hsp3net 専用 (intptr / NSTRUCT / wstr を使用)。 |
| タイプ | 拡張命令 |
| グループ | Win32API |
| 対応環境 |
|
| hs ファイル | hsphelp\win32_kernel32_gen2.hs |