FunctionIDMapper2 函式
向分析工具告知,函式的指定識別項可能會已重新對應至替代 ID 以使用於該函式的 FunctionEnter3、FunctionLeave3 和 FunctionTailcall3 回呼或是FunctionEnter3WithInfo、FunctionLeave3WithInfo 和 FunctionTailcall3WithInfo 回呼。 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 函式 函式。 用戶端資料是用來在執行階段間進行清楚的識別。
需求
**平台:**請參閱 .NET Framework 系統需求。
**標頭:**CorProf.idl
**程式庫:**CorGuids.lib
**.NET Framework 版本:**4
請參閱
參考
ICorProfilerInfo::SetFunctionIDMapper
ICorProfilerInfo3::SetFunctionIDMapper2