Метод IDebugClient3::CreateProcessWide (dbgeng.h)

Метод CreateProcessWide создает процесс из указанной командной строки.

Синтаксис

HRESULT CreateProcessWide(
  [in] ULONG64 Server,
  [in] PWSTR   CommandLine,
  [in] ULONG   CreateFlags
);

Параметры

[in] Server

Указывает сервер обработки, используемый при подключении к процессу. Если значение Server равно нулю, подсистема создаст локальный процесс без использования сервера обработки.

[in] CommandLine

Указывает командную строку, выполняемую для создания нового процесса. Метод CreateProcessWide может изменять содержимое строки, указанной в этом параметре. Таким образом, этот параметр не может быть указателем на память только для чтения (например, переменную const или литеральную строку). Передача константной строки в этом параметре может привести к нарушению доступа.

[in] CreateFlags

Указывает флаги, используемые при создании процесса. Дополнительные сведения об этих флагах см. в разделе Элемент CreateFlags структуры DEBUG_CREATE_PROCESS_OPTIONS .

Возвращаемое значение

Этот метод также может возвращать значения ошибок. Дополнительные сведения см. в разделе Возвращаемые значения .

Код возврата Описание
S_OK
Метод выполнен успешно.

Комментарии

Этот метод доступен только для динамической отладки в пользовательском режиме.

Если CreateFlags содержит любой из флагов DEBUG_PROCESS или DEBUG_ONLY_THIS_PROCESS, подсистема также подключается к только что созданному процессу. Это поведение аналогично поведению CreateProcessAndAttach2 , если для аргумента ProcessId задано нулевое значение.

Дополнительные сведения о создании и подключении к динамическим целевым объектам пользовательского режима см. в разделе Live User-Mode Targets.

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть dbgeng.h (включая Dbgeng.h)

См. также раздел

.create (Create Process)

AttachProcess

ConnectProcessServer

CreateProcess2

CreateProcessAndAttach2

IDebugClient3

IDebugClient4

IDebugClient5