Функция DebugActiveProcess (debugapi.h)

Статья
08/23/2023

Позволяет отладчику подключаться к активному процессу и выполнять его отладку.

Синтаксис

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 . Элемент lpStartAddress структуры CREATE_PROCESS_DEBUG_INFO имеет значение NULL.

Для каждого потока, который в данный момент является частью процесса, система отправляет событие отладки CREATE_THREAD_DEBUG_EVENT . Элемент lpStartAddress структуры CREATE_THREAD_DEBUG_INFO имеет значение NULL.

Для каждой динамической библиотеки (DLL), загруженной в адресное пространство целевого процесса, система отправляет событие отладки LOAD_DLL_DEBUG_EVENT . Система упорядочивает первый поток в процессе для выполнения инструкции точки останова после возобновления. Продолжение этого потока приводит к тому, что он возвращается к выполнению того же действия, что и до присоединения отладчика.

После этого система возобновляет все потоки в процессе. Когда первый поток в процессе возобновляется, он выполняет инструкцию точки останова, которая приводит к отправке события отладки EXCEPTION_DEBUG_EVENT в отладчик. Все будущие события отладки отправляются в отладчик с помощью обычного механизма и правил.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	debugapi.h (включая Windows.h)
Библиотека	Kernel32.lib
DLL	Kernel32.dll