ICorProfilerInfo4::RequestRevert Method

Article
04/07/2022

Reverts all instances of the specified functions to their original versions.

Syntax

HRESULT RequestRevert (  
   [in] ULONG    cFunctions,  
   [in, size_is(cFunctions)]  ModuleID    moduleIds[],  
   [in, size_is(cFunctions)]  mdMethodDef methodIds[],  
   [out, size_is(cFunctions)]  HRESULT status[]);

Parameters

cFunctions
[in] The number of functions to revert.

moduleIds
[in] Specifies the moduleId portion of the (module, methodDef) pairs that identify the functions to be reverted.

methodIds
[in] Specifies the methodId portion of the (module, methodDef) pairs that identify the functions to be reverted.

status
[out] An array of HRESULTs listed in the "Status HRESULTs" section later in this topic. Each HRESULT indicates the success or failure of trying to revert each function specified in the parallel arrays moduleIds and methodIds.

Return Value

This method returns the following specific HRESULTs as well as HRESULT errors that indicate method failure.

HRESULT	Description
S_OK	An attempt was made to revert all requests; however, the returned status array must be checked to determine which functions were successfully reverted.
CORPROF_E_CALLBACK4_REQUIRED	The profiler must implement the ICorProfilerCallback4 interface for this call to be supported.
CORPROF_E_REJIT_NOT_ENABLED	JIT recompilation has not been enabled. You must enable JIT recompilation during initialization by using the ICorProfilerInfo::SetEventMask method to set the `COR_PRF_ENABLE_REJIT` flag.
E_INVALIDARG	`cFunctions` is 0, or `moduleIds` or `methodIds` is `NULL`.
E_OUTOFMEMORY	The CLR was unable to complete the request because it ran out of memory.

Status HRESULTS

Status array HRESULT	Description
S_OK	The corresponding function was successfully reverted.
E_INVALIDARG	The `moduleID` or `methodDef` parameter is `NULL`.
CORPROF_E_DATAINCOMPLETE	The module is not fully loaded yet, or it is in the process of being unloaded.
CORPROF_E_MODULE_IS_DYNAMIC	The specified module was dynamically generated (for example by `Reflection.Emit`). Therefore, it is not supported by this method.
CORPROF_E_ACTIVE_REJIT_REQUEST_NOT_FOUND	The CLR could not revert the specified function, because a corresponding active recompilation request was not found. Either the recompilation was never requested or the function was already reverted.
Other	The operating system returned a failure outside the control of the CLR. For example, if a system call to change the access protection of a page of memory fails, the operating system error will be displayed.

Remarks

The next time any of the reverted function instances are called, the original versions of the functions will be run. If a function is already running, it will finish executing the version that is running.

Requirements

Platforms: See System Requirements.

Header: CorProf.idl, CorProf.h

Library: CorGuids.lib

.NET Framework Versions: Available since 4.5

Share via