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

要求

   
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 winbase.h (包括 Windows.h)
Library Kernel32.lib
DLL Kernel32.dll

另请参阅

IsBadCodePtr

IsBadReadPtr

IsBadWritePtr