isBadStringPtrW 函数 (winbase.h)

验证调用进程是否对指定的内存范围具有读取访问权限。

重要此函数已过时，不应使用。尽管有其名称，但它不保证指针有效或指向的内存可以安全使用。有关详细信息，请参阅此页上的“备注”。

语法

BOOL IsBadStringPtrW(
  [in] LPCWSTR  lpsz,
  [in] UINT_PTR ucchMax
);

[in] lpsz

指向以 null 结尾的字符串（Unicode 或 ASCII）的指针。

[in] ucchMax

字符串的最大大小（以 TCHAR 为单位）。函数检查所有字符的读取访问权限，最大为字符串的终止 null 字符或此参数指定的字符数，以较小者为准。如果此参数为零，则返回值为零。

如果调用进程对字符串的终止 null 字符或最多 由 ucchMax 指定的字符数的所有字符具有读取访问权限，则返回值为零。

如果调用进程对字符串的终止 null 字符或不超过 ucchMax 指定的字符数的所有字符没有读取访问权限，则返回值为非零。

如果应用程序编译为调试版本，并且进程对指定的整个内存范围没有读取访问权限，则函数会导致断言并中断调试器。离开调试器后，函数会像往常一样继续，并返回一个非零值。此行为是设计使然，作为调试辅助。

此函数通常在处理从第三方库返回的指针时使用，在该库中无法确定第三方 DLL 中的内存管理行为。

进程中的线程应以这样一种方式协同工作，这样一个进程就不会释放另一个线程所需的内存。使用此函数不会否定执行此操作的需要。如果不这样做，应用程序可能会以不可预知的方式失败。

取消引用可能无效的指针可能会禁用其他线程中的堆栈扩展。当禁用堆栈扩展时，线程耗尽其堆栈会导致父进程立即终止，没有弹出窗口错误窗口或诊断信息。

如果调用进程对指定内存范围的某些（而不是全部）具有读取访问权限，则返回值为非零值。

在抢占式多任务环境中，其他线程可能会更改进程对所测试内存的访问。即使函数指示进程具有对指定内存的读取访问权限，在尝试访问内存时，也应使用结构化异常处理。使用结构化异常处理可让系统在发生访问冲突异常时通知进程，使进程有机会处理异常。

注意

winbase.h 标头将 IsBadStringPtr 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。有关详细信息，请参阅函数原型的约定。