Метод IDebugClient5::CreateProcess2Wide (dbgeng.h)
Метод CreateProcess2Wide выполняет указанную команду для создания нового процесса.
Синтаксис
HRESULT CreateProcess2Wide(
[in] ULONG64 Server,
[in] PWSTR CommandLine,
[in] PVOID OptionsBuffer,
[in] ULONG OptionsBufferSize,
[in, optional] PCWSTR InitialDirectory,
[in, optional] PCWSTR Environment
);
Параметры
[in] Server
Указывает сервер обработки, который будет присоединен к процессу. Если значение Server равно нулю, подсистема создаст локальный процесс без использования сервера обработки.
[in] CommandLine
Указывает командную строку, выполняемую для создания нового процесса.
[in] OptionsBuffer
Указывает параметры создания процесса. OptionsBuffer — это указатель на структуру DEBUG_CREATE_PROCESS_OPTIONS .
[in] OptionsBufferSize
Задает размер буфера OptionsBuffer. Для этого параметра должно быть задано значение sizeof(DEBUG_CREATE_PROCESS_OPTIONS).
[in, optional] InitialDirectory
Указывает начальный каталог для процесса. Если InitialDirectory имеет значение NULL, используется текущий каталог для сервера обработки.
[in, optional] Environment
Задает блок среды для нового процесса. Блок среды состоит из блока строк, завершаемых значением NULL. Каждая строка имеет следующий вид:
name=value
Обратите внимание, что два последних символа блока среды имеют значение NULL: один для завершения строки и один для завершения блока.
Если параметр Environment имеет значение NULL, новый процесс наследует блок среды сервера обработки. Если флаг DEBUG_CREATE_PROCESS_THROUGH_RTL задан в разделе ПараметрыBuffer, то значение Environment должно иметь значение NULL.
Возвращаемое значение
Этот метод также может возвращать значения ошибок. Дополнительные сведения см. в разделе Возвращаемые значения .
Код возврата | Описание |
---|---|
|
Метод выполнен успешно. |
Комментарии
Этот метод доступен только для динамической отладки в пользовательском режиме.
Если CreateFlags содержит любой из флагов DEBUG_PROCESS или DEBUG_ONLY_THIS_PROCESS, подсистема также присоединится к созданному процессу. Это похоже на поведение CreateProcessAndAttach2 с аргументом ProcessId , равным нулю.
Дополнительные сведения о создании и подключении к целевым объектам активного пользовательского режима см. в разделе Live User-Mode Targets.
Требования
Требование | Значение |
---|---|
Целевая платформа | Персональный компьютер |
Верхняя часть | dbgeng.h (включая Dbgeng.h) |
См. также раздел
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по