Comparteix a través de

FunctionIDMapper2 (Función)

  • Article

Notifica al generador de perfiles que el identificador especificado de una función puede reasignarse a otro identificador que se va a usar en las devoluciones de llamada FunctionEnter3, FunctionLeave3 y FunctionTailcall3 o las devoluciones de llamada FunctionEnter3WithInfo, FunctionLeave3WithInfo y FunctionTailcall3WithInfo de esa función. Además, FunctionIDMapper2 permite al generador de perfiles indicar si desea recibir devoluciones de llamada de esa función.

Sintaxis

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

Parámetros

funcId [in] Identificador de la función que se va a reasignar.

clientData [in] Puntero a datos que se usa para eliminar la ambigüedad entre los runtime.

pbHookFunction[out] Puntero a un valor que el generador de perfiles establece en true si desea recibir devoluciones de llamada FunctionEnter3, FunctionLeave3 y FunctionTailcall3, o FunctionEnter3WithInfo, FunctionLeave3WithInfo yFunctionTailcall3WithInfo. De lo contrario, establece este valor en false.

Valor devuelto

El generador de perfiles devuelve un valor que el motor de ejecución utiliza como identificador de función alternativo. El valor devuelto no puede ser null a menos que se devuelva false en pbHookFunction. De lo contrario, la devolución de un valor nulo genera resultados imprevisibles, que posiblemente incluyan la detención del proceso.

Comentarios

Este método extiende la función FunctionIDMapper con un parámetro adicional que se usa para pasar datos del cliente. Los datos del cliente se usan para eliminar la ambigüedad entre los runtime.

Requisitos

Plataformas: Vea Requisitos de sistema.

Encabezado: CorProf.idl

Biblioteca: CorGuids.lib

Versiones de .NET Framework: disponible a partir de la versión 4

Consulte también