Função FunctionIDMapper2

Artigo
05/10/2023

Notifica o criador de perfil de que o identificador determinado de uma função pode ser remapeado para uma ID alternativa a ser usada nos retornos de chamada FunctionEnter3, FunctionLeave3 e FunctionTailcall3 ouFunctionEnter3WithInfo, FunctionLeave3WithInfo e FunctionTailcall3WithInfo para essa função. FunctionIDMapper2também permite que o criador de perfil indique se deseja receber retornos de chamada para essa função.

Sintaxe

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

Parâmetros

funcId [in] O identificador de função a ser remapeado.

clientData [in] Um ponteiro para dados usados para desambiguar entre runtimes.

pbHookFunction[out] Um ponteiro para um valor que o criador de perfil define para true se quiser receber FunctionEnter3, FunctionLeave3 e FunctionTailcall3, ou FunctionEnter3WithInfo, FunctionLeave3WithInfo e FunctionTailcall3WithInfo retornos de chamada; caso contrário, ele define esse valor como false.

Valor Retornado

O criador de perfil retorna um valor que o mecanismo de execução usa como um identificador de função alternativa. O valor retornado não pode ser nulo, a menos que false seja retornado em pbHookFunction. Caso contrário, um valor de retorno nulo produz resultados imprevisíveis, incluindo possivelmente a interrupção do processo.

Comentários

Esse método estende a função FunctionIDMapper com um parâmetro adicional que é usado para transmitir dados do cliente. Os dados do cliente são usados para desambiguar entre runtimes.

Requisitos

Plataformas: confira Requisitos do sistema.

Cabeçalho: CorProf.idl

Biblioteca: CorGuids.lib

Versões do .NET Framework: disponíveis desde 4

Compartilhar via