通知分析工具,函式的指定識別碼可能會重新對應至替代識別碼,以用於 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,除非 false 傳回在 pbHookFunction 中。 否則,傳回的 null 值會產生無法預期的結果,包括可能暫止處理序。
備註
這個方法會以用來傳遞用戶端資料的額外參數來擴充 FunctionIDMapper 函式。 用戶端資料會用來區分執行階段。
規格需求
平台:請參閱系統需求。
標頭:CorProf.idl
程式庫:CorGuids.lib
.NET Framework版本:自 4 起可用