IsBadStringPtrW

呼び出し側プロセスが指定したメモリ範囲に対して読み取りアクセス権を持つかを検証する。(IsBadStringPtrW)

IsBadStringPtrW lpsz, ucchMax

lpsz : [wstr] Unicode または ASCII の null 終端文字列へのポインタ。
ucchMax : [int] 文字列の最大サイズ (TCHAR 単位)。関数は、文字列の終端 null 文字まで、もしくはこのパラメータで指定した文字数のいずれか小さい方の文字数について読み取りアクセスをチェックする。このパラメータが 0 の場合、戻り値は 0 となる。

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

解説

呼び出し側プロセスが指定したメモリ範囲に対して読み取りアクセス権を持つかを検証する。(IsBadStringPtrW)

[戻り値]
呼び出し側プロセスが、文字列の終端 null 文字または ucchMax
で指定した文字数までのすべての文字に対して読み取りアクセス権を持つ場合、戻り値は 0 となる。持たない場合、戻り値は 0
以外となる。デバッグ
ビルドでコンパイルされ、指定メモリ範囲全体に対して読み取りアクセス権を持たない場合、関数はアサートしデバッガに入る。デバッガを抜けると関数は通常どおり続行し
0 以外の値を返す。これはデバッグ支援として意図された動作である。

[備考]
この関数は通常、サードパーティ ライブラリから返されたポインタを扱うときに使われる。サードパーティ DLL
のメモリ管理動作を判断できない場合である。プロセス内のスレッドは互いに協調し、一方が他方の必要とするメモリを解放しないようにすることが期待される。この関数の使用はその必要性を排除しない。これを行わないと、アプリケーションは予測不能な形で失敗することがある。無効である可能性のあるポインタの参照解決は、他のスレッドのスタック拡張を無効にしてしまう可能性がある。スタック拡張が無効化された状態でスレッドがスタックを使い切ると、親プロセスはポップアップ
エラー ウィンドウや診断情報を出さずに直ちに終了する。呼び出し側プロセスが指定メモリ範囲の一部にのみ読み取りアクセス権を持つ場合、戻り値は
0 以外となる。プリエンプティブ
マルチタスク環境では、検査中のメモリに対するプロセスのアクセス権を他のスレッドが変更する可能性がある。たとえ関数が読み取りアクセスありと報告してもメモリへアクセスする際は構造化例外処理を使うべきである。構造化例外処理を使えば、アクセス違反例外が発生した際にシステムからプロセスに通知され、プロセスは例外を処理する機会を得られる。
> [!NOTE] > winbase.h ヘッダーは IsBadStringPtr を、UNICODE
プリプロセッサ定数の定義に基づいて ANSI 版か Unicode
版を自動選択するエイリアスとして定義している。エンコーディング中立のエイリアスとそうでないコードを混在させると、コンパイルまたは実行時エラーになるミスマッチが発生することがある。詳細は
[Conventions for Function
Prototypes](/windows/win32/intl/conventions-for-function-prototypes)
を参照のこと。

情報