呼び出し側プロセスが指定したメモリ範囲に対して読み取りアクセス権を持つかを検証する。(IsBadReadPtr)
IsBadReadPtr lp, ucb
lp : [intptr] メモリ ブロックの先頭バイトへのポインタ。 ucb : [int] メモリ ブロックのサイズ(バイト単位)。このパラメータが 0 の場合、戻り値は 0 となる。
(プラグイン / モジュール : kernel32.dll)
呼び出し側プロセスが指定したメモリ範囲に対して読み取りアクセス権を持つかを検証する。(IsBadReadPtr) [戻り値] 呼び出し側プロセスが指定メモリ範囲のすべてのバイトに対して読み取りアクセス権を持つ場合、戻り値は 0 となる。持たない場合、戻り値は 0 以外となる。デバッグ ビルドでコンパイルされ、指定メモリ範囲のすべてのバイトに対して読み取りアクセス権を持たない場合、関数はアサートしデバッガに入る。デバッガを抜けると関数は通常どおり続行し 0 以外の値を返す。これはデバッグ支援として意図された動作である。 [備考] この関数は通常、サードパーティ ライブラリから返されたポインタを扱うときに使われる。サードパーティ DLL のメモリ管理動作を判断できない場合である。プロセス内のスレッドは互いに協調し、一方が他方の必要とするメモリを解放しないようにすることが期待されている。この関数の使用はその必要性を排除しない。これを行わないと、アプリケーションは予測不能な形で失敗することがある。無効である可能性のあるポインタの参照解決は、他のスレッドのスタック拡張を無効にしてしまう可能性がある。スタック拡張が無効化された状態でスレッドがスタックを使い切ると、親プロセスはポップアップ エラー ウィンドウや診断情報を出さずに直ちに終了する。呼び出し側プロセスが指定メモリ範囲内の一部バイトに対してのみ読み取りアクセス権を持つ場合、戻り値は 0 以外となる。プリエンプティブ マルチタスク環境では、検査中のメモリに対するプロセスのアクセス権を他のスレッドが変更する可能性がある。たとえ関数が読み取りアクセスありと報告してもメモリへアクセスする際は構造化例外処理を使うべきである。構造化例外処理を使えば、アクセス違反例外が発生した際にシステムからプロセスに通知され、プロセスは例外を処理する機会を得られる。
| プラグイン / モジュール | 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 |