共用方式為

FunctionIDMapper2 函式

  • 發行項

通知分析工具，函式的指定識別碼可能會重新對應至替代識別碼，以用於 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 起可用

另請參閱