FunctionLeave2 函数

2008-08-18

更新：2007 年 11 月

通知探查器函数即将返回到调用方，并提供有关堆栈帧和函数返回值的信息。

void FunctionLeave2 (
        [in]  FunctionID                        funcId,
        [in]  UINT_PTR                          clientData,
        [in]  COR_PRF_FRAME_INFO                func,
        [in]  COR_PRF_FUNCTION_ARGUMENT_RANGE  *retvalRange
);

参数

funcId
[in] 正在返回的函数的标识符。
clientData
[in] 探查器以前通过 FunctionIDMapper 函数指定的重新映射的函数标识符。
func
[in] 一个 COR_PRF_FRAME_INFO 值，该值指向有关堆栈帧的信息。

探查器应将此值视为可回传到 ICorProfilerInfo2::GetFunctionInfo2 方法中的执行引擎的不透明句柄。
retvalRange
[in] 一个指向 COR_PRF_FUNCTION_ARGUMENT_RANGE 结构的指针，该结构指定函数的返回值的内存位置。

为了访问返回值信息，必须设置 COR_PRF_ENABLE_FUNCTION_RETVAL 标志。探查器可以使用 ICorProfilerInfo::SetEventMask 方法设置事件标志。