Metodo ICorDebugProcess2::SetDesiredNGENCompilerFlags

Articolo
08/11/2011

Imposta i flag che devono essere incorporati in un'immagine precompilata per consentire al runtime di caricare quell'immagine nel processo corrente.

HRESULT SetDesiredNGENCompilerFlags (
    [in] DWORD    pdwFlags
);

Parametri

pdwFlags
[in] Valore dell'enumerazione CorDebugJITCompilerFlags che specifica i flag del compilatore utilizzati per selezionare l'immagine precompilata corretta.

Note

Il metodo SetDesiredNGENCompilerFlags specifica i flag che devono essere incorporati in un'immagine precompilata per consentire al runtime di caricarla in questo processo. I flag impostati da questo metodo sono utilizzati solo per selezionare l'immagine precompilata corretta. Se l'immagine non esiste, il runtime caricherà l'immagine MSIL e il compilatore JIT. In tal caso, il debugger deve comunque utilizzare il metodo ICorDebugModule2::SetJITCompilerFlags per impostare i flag nel modo richiesto per la compilazione JIT.

Se un'immagine viene caricata ma richiede una parte di compilazione JIT (ad esempio nel caso in cui l'immagine contenga dei generics), i flag del compilatore specificati dal metodo SetDesiredNGENCompilerFlags si applicheranno alla compilazione JIT aggiuntiva.

Il metodo SetDesiredNGENCompilerFlags deve essere chiamato durante il callback di ICorDebugManagedCallback::CreateProcess. I tentativi di chiamata al metodo SetDesiredNGENCompilerFlags effettuati successivamente avranno esito negativo. Inoltre, i tentativi di impostare flag che non sono definiti nell'enumerazione CorDebugJITCompilerFlags o che non sono consentiti per il processo specificato avranno esito negativo.