IDebugClient3::CreateProcess method (dbgeng.h)

Article
02/22/2024

The CreateProcess method creates a process from the specified command line.

Syntax

HRESULT CreateProcess(
  [in] ULONG64 Server,
  [in] PSTR    CommandLine,
  [in] ULONG   CreateFlags
);

Parameters

[in] Server

Specifies the process server to use to attach to the process. If Server is zero, the engine will create a local process without using a process server.

[in] CommandLine

Specifies the command line to execute to create the new process.

[in] CreateFlags

Specifies the flags to use when creating the process. For details on these flags, see the CreateFlags member of the DEBUG_CREATE_PROCESS_OPTIONS structure.

Return value

This method may also return error values. See Return Values for more details.

Return code	Description
S_OK	The method was successful.

Remarks

This method is available only for live user-mode debugging.

If CreateFlags contains either of the flags DEBUG_PROCESS or DEBUG_ONLY_THIS_PROCESS, the engine will also attach to the newly created process; this is similar to the behavior of CreateProcessAndAttach2 with its argument ProcessId set to zero.

For more information about creating and attaching to live user-mode targets, see Live User-Mode Targets.

Requirements

Requirement	Value
Target Platform	Desktop
Header	dbgeng.h (include Dbgeng.h)