DebugActiveProcess 函数 (debugapi.h)

项目
03/13/2024

使调试程序能够附加到活动进程并对其进行调试。

语法

BOOL DebugActiveProcess(
  [in] DWORD dwProcessId
);

参数

[in] dwProcessId

要调试的进程标识符。向调试器授予对进程的调试访问权限，就像它使用 DEBUG_ONLY_THIS_PROCESS 标志创建进程一样。有关详细信息，请参阅本主题的“备注”部分。

返回值

如果该函数成功，则返回值为非零值。

如果函数失败，则返回值为 0（零）。要获得更多的错误信息，请调用 GetLastError。

注解

若要停止调试进程，必须退出进程或调用 DebugActiveProcessStop 函数。退出调试器也会退出进程，除非使用 DebugSetProcessKillOnExit 函数。

调试器必须对目标进程具有适当的访问权限，并且必须能够打开进程进行 PROCESS_ALL_ACCESS。如果目标进程是使用安全描述符创建的，该安全描述符授予调试器任何低于完全访问权限的权限，DebugActiveProcess 可能会失败。如果调试进程已授予并启用了 SE_DEBUG_NAME 特权，则可以调试任何进程。

在系统检查进程标识符并确定正在生成有效的调试附件后，函数将返回 TRUE。然后，调试器应使用 WaitForDebugEvent 函数等待调试事件。系统挂起进程中的所有线程，并发送表示进程的当前状态的调试器事件。

系统向调试器发送单个 CREATE_PROCESS_DEBUG_EVENT 调试事件，该事件表示 由 dwProcessId 参数指定的进程。 CREATE_PROCESS_DEBUG_INFO 结构的 lpStartAddress 成员为 NULL。

对于当前属于进程的每个线程，系统会发送 一个CREATE_THREAD_DEBUG_EVENT 调试事件。 CREATE_THREAD_DEBUG_INFO 结构的 lpStartAddress 成员为 NULL。

对于当前加载到目标进程的地址空间中的每个动态链接库 (DLL) ，系统会发送 LOAD_DLL_DEBUG_EVENT 调试事件。系统安排进程中的第一个线程在恢复后执行断点指令。继续此线程会使它恢复执行与附加调试器之前相同的操作。

完成所有这些操作后，系统将恢复进程中的所有线程。当进程中的第一个线程恢复时，它会执行断点指令，导致 将EXCEPTION_DEBUG_EVENT 调试事件发送到调试器。所有将来的调试事件都通过使用常规机制和规则发送到调试器。

要求

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