DEBUG_CREATE_PROCESS_OPTIONS structure

The DEBUG_CREATE_PROCESS_OPTIONS structure specifies the process creation options to use when creating a new process.

Syntax


typedef struct _DEBUG_CREATE_PROCESS_OPTIONS {
  ULONG CreateFlags;
  ULONG EngCreateFlags;
  ULONG VerifierFlags;
  ULONG Reserved;
} DEBUG_CREATE_PROCESS_OPTIONS, *PDEBUG_CREATE_PROCESS_OPTIONS;

Members

CreateFlags

The flags to use when creating the process. In addition to the flags described in the "Process Creation Flags" topic in the Platform SDK documentation, the debugger engine uses the following flags when creating a process.

ValuesDescription

DEBUG_CREATE_PROCESS_NO_DEBUG_HEAP

(Microsoft Windows Server 2003 and later) Prevents the debug heap from being used in the new process.

DEBUG_CREATE_PROCESS_THROUGH_RTL

The native NT RTL process creation routines should be used instead of Win32. This is only meaningful for special processes that run as NT native processes. No Win32 process can be created with this flag.

 

When creating and attaching to a process through the debugger engine, set one of the Platform SDK's process creation flags: DEBUG_PROCESS or DEBUG_ONLY_THIS_PROCESS.

EngCreateFlags

The engine specific flags used when creating the process. EngCreateFlags is a combination of the following bit-flags:

ValueDescription

DEBUG_ECREATE_PROCESS_INHERIT_HANDLES

The new process will inherit system handles from the debugger or process server.

DEBUG_ECREATE_PROCESS_USE_VERIFIER_FLAGS

(Windows Vista and later) Use Application Verifier flags in the VerifierFlags field.

DEBUG_ECREATE_PROCESS_USE_IMPLICIT_COMMAND_LINE

Use the debugger's or process server's implicit command line to start the process instead of a supplied command line.

 

VerifierFlags

The Application Verifier flags. Only used if DEBUG_ECREATE_PROCESS_USE_VERIFIER_FLAGS is set in the EngCreateFlags field. For possible values, see the Application Verifier documentation.

Reserved

Set to zero.

Requirements

Header

DbgEng.h (include DbgEng.h)

 

 

Send comments about this topic to Microsoft

Show: