ICorDebugProcess2::SetDesiredNGENCompilerFlags-Methode

Artikel
09/02/2008

Aktualisiert: November 2007

Legt die Flags fest, die in einem vorkompilierten Abbild eingebettet sein müssen, damit die Laufzeit das Abbild in den aktuellen Prozess laden kann.

HRESULT SetDesiredNGENCompilerFlags (
       [in] DWORD    pdwFlags
);

Parameter

pdwFlags
[in] Ein Wert der CorDebugJITCompilerFlags-Enumeration, mit dem die Compilerflags angegeben werden, die zum Auswählen des richtigen vorkompilierten Abbilds verwendet werden.

Hinweise

Die SetDesiredNGENCompilerFlags-Methode gibt die Flags an, die in einem vorkompilierten Abbild eingebettet sein müssen, damit die Laufzeit das Abbild in diesem Prozess lädt. Die von dieser Methode festgelegten Flags werden nur verwendet, um das richtige vorkompilierte Abbild auszuwählen. Wenn kein solches Abbild vorhanden ist, lädt die Laufzeit stattdessen die Microsoft Intermediate Language (MSIL) und den Just-In-Time-Compiler (JIT). In diesem Fall muss der Debugger weiterhin die ICorDebugModule2::SetJITCompilerFlags-Methode verwenden, um die Flags für die JIT-Kompilierung wie gewünscht festzulegen.

Wenn ein Abbild geladen wird und einige JIT-Kompilierung für dieses Abbild erfolgen muss (was der Fall ist, wenn das Abbild generische Typen enthält), werden die von der SetDesiredNGENCompilerFlags-Methode angegebenen Compilerflags auf die zusätzliche JIT-Kompilierung angewendet.

Die SetDesiredNGENCompilerFlags-Methode muss während des ICorDebugManagedCallback::CreateProcess-Rückrufs aufgerufen werden. Versuche, die SetDesiredNGENCompilerFlags-Methode danach aufzurufen, schlagen fehl. Darüber hinaus tritt ein Fehler auf, wenn Sie versuchen, Flags festzulegen, die entweder in der CorDebugJITCompilerFlags-Enumeration nicht definiert sind oder für den angegebenen Prozess ungültig sind.