ICorDebugProcess2::SetDesiredNGENCompilerFlags Method

Sets the flags that must match those embedded in a pre-compiled image in order for the runtime to load that image into the current process.

HRESULT SetDesiredNGENCompilerFlags (
    [in] DWORD                     pdwFlags
);

Parameters

Remarks

The SetDesiredNGENCompilerFlags method specifies the flags that must be embedded in a pre-compiled image so that the runtime will load that image into this process. The flags set by this method are used only to select the correct pre-compiled image. If no such image exists, the runtime will load the Microsoft intermediate language (MSIL) image and the just-in-time (JIT) compiler instead, in which case, the debugger must still use ICorDebugModule2::SetJITCompilerFlags Method to set the flags as desired for the JIT compilation.

If an image is loaded, but some JIT compiling must take place for that image (as will be the case if the image contains generics), the compiler flags specified by the SetDesiredNGENCompilerFlags method will apply to the extra JIT compilation.

The SetDesiredNGENCompilerFlags method must be called during the ICorDebugManagedCallback::CreateProcess Method callback. Attempts to call the SetDesiredNGENCompilerFlags method afterwards will fail. Also, attempts to set flags that are either not defined in CorDebugJITCompilerFlags Enumeration or are not legal for the given process, will fail.

Requirements

Platforms: Windows 2000, Windows XP, Windows Server 2003 family

Header: CorDebug.idl

Library: CorGuids.lib

.NET Framework Version: 2.0

See Also

Reference

ICorDebugProcess2 Interface
ICorDebugProcess Interface
ICorDebug Interface
ICorDebugManagedCallback Interface