IDebugClient2::CreateProcess method (dbgeng.h)
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 |
|---|---|
|
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) |