IDebugClient::CreateProcess method

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

Syntax


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

Parameters

Server [in]

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.

CommandLine [in]

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

CreateFlags [in]

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 codeDescription
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

Target platform

Desktop

Header

Dbgeng.h (include Dbgeng.h)

See also

IDebugClient
IDebugClient2
IDebugClient3
IDebugClient4
IDebugClient5
CreateProcess2
AttachProcess
CreateProcessAndAttach2
.create (Create Process)
ConnectProcessServer

 

 

Send comments about this topic to Microsoft

Show: