ICorDebugProcess2::SetDesiredNGENCompilerFlags (Método)

Artículo
08/10/2011

Establece los marcadores que se deben incrustar en una imagen precompilada para que el motor de tiempo de ejecución cargue esa imagen en el proceso actual.

HRESULT SetDesiredNGENCompilerFlags (
    [in] DWORD    pdwFlags
);

Parámetros

pdwFlags
[in] Valor de la enumeración CorDebugJITCompilerFlags que especifica los marcadores del compilador utilizados para seleccionar la imagen precompilada correcta.

Comentarios

El método SetDesiredNGENCompilerFlags especifica los marcadores que se deben incrustar en una imagen precompilada para que el motor de tiempo de ejecución cargue esa imagen en este proceso. Los marcadores establecidos por este método solamente se utilizan para seleccionar la imagen precompilada correcta. Si la imagen no existe, el motor en tiempo de ejecución cargará el lenguaje intermedio de Microsoft (MSIL) y el compilador Just-In-Time (JIT) en su lugar. En ese caso, el depurador debe utilizar todavía el método ICorDebugModule2::SetJITCompilerFlags para establecer los marcadores deseados para la compilación JIT.

Si se carga una imagen, pero debe tener lugar alguna compilación JIT para esa imagen (lo que será el caso si la imagen contiene genéricos), los marcadores del compilador especificados por el método SetDesiredNGENCompilerFlags se aplicarán a la compilación JIT adicional.

Se debe llamar al método SetDesiredNGENCompilerFlags durante la devolución de llamada ICorDebugManagedCallback::CreateProcess. Si se intenta llamar más tarde al método SetDesiredNGENCompilerFlags, se producirá un error. Además, los intentos de establecer marcadores que no estén definidos en la enumeración CorDebugJITCompilerFlags o no sean legales para el proceso determinado no darán ningún resultado.