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 版本。将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。有关详细信息，请参阅函数原型的约定。