isBadWritePtr 函数 (winbase.h)

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

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

语法

BOOL IsBadWritePtr(
  [in] LPVOID   lp,
  [in] UINT_PTR ucb
);

[in] lp

指向内存块的第一个字节的指针。

[in] ucb

内存块的大小（以字节为单位）。如果此参数为零，则返回值为零。

如果调用进程对指定内存范围中的所有字节具有写入访问权限，则返回值为零。

如果调用进程不具有对指定内存范围中所有字节的写入访问权限，则返回值为非零值。

如果应用程序在调试器下运行，并且进程对指定内存范围中的所有字节没有写入访问权限，则函数会导致第一次STATUS_ACCESS_VIOLATION异常。可以针对此条件将调试器配置为中断。在调试器中恢复进程执行后，函数照常继续，并返回一个非零值。此行为是设计使然，用作调试辅助。

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

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

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

如果调用进程对指定内存范围内部分（而不是全部）字节具有写入访问权限，则返回值为非零值。

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

IsBadWritePtr 不是多线程安全的。若要在多个线程共享的指针上正确使用它，请在仅允许一个线程访问所检查的内存的关键代码区域中调用它。使用操作系统级对象（如关键部分、互斥体或互锁函数）创建代码的关键区域。