通过

FunctionIDMapper2 函数

通知探查器，函数的给定标识符可能重新映射到该函数的 FunctionEnter3、FunctionLeave3 和 FunctionTailcall3，或 FunctionEnter3WithInfo、FunctionLeave3WithInfo 和 FunctionTailcall3WithInfo 回调中的备用 ID。 FunctionIDMapper2 此外还要使探查器指示它是否想要接收该函数的回调。

语法

UINT_PTR __stdcall FunctionIDMapper2 (  
    [in]  FunctionID  funcId,  
    [in]  void * clientData,  
    [out] BOOL       *pbHookFunction  
);

参数

funcId [in] 要重新映射的函数标识符。

clientData[in] 指向用于消除运行时之间歧义的数据的指针。

pbHookFunction[out] 指向一个值的指针，如果探查器想要接收 FunctionEnter3、FunctionLeave3 和 FunctionTailcall3，或 FunctionEnter3WithInfo、FunctionLeave3WithInfo 和 FunctionTailcall3WithInfo 回调而将该值设置为 true； 否则，它会将此值设置为 false。

返回值

探查器返回一个执行引擎用作替代函数标识符的值。 返回值不能为 null，除非在 pbHookFunction 中返回 false。 否则为 null 的返回值将产生不可预知的结果，包括可能停止该过程。

注解

此方法使用一个用于传递客户端数据的附加参数对 FunctionIDMapper 函数进行了扩展。 客户端数据用于消除运行时之间的歧义。

要求

平台：请参阅系统要求。

标头：CorProf.idl

库：CorGuids.lib

.NET Framework 版本：自 4 起可用

另请参阅