Método de ICorProfilerInfo2::GetFunctionFromTokenAndTypeArgs

Artigo
08/08/2011

Obtém o FunctionID de uma função usando o token de metadados especificado, que contém a classe, e ClassID valores de quaisquer argumentos de tipo.

HRESULT GetFunctionFromTokenAndTypeArgs(
    [in] ModuleID moduleID,
    [in] mdMethodDef funcDef,
    [in] ClassID classId,
    [in] ULONG32 cTypeArgs,
    [in, size_is(cTypeArgs)] ClassID typeArgs[],
    [out] FunctionID* pFunctionID);

Parâmetros

moduleID
[in] A ID do módulo no qual a função reside.
funcDef
[in] Um mdMethodDef o token de metadados que faz referência a função.
classId
[in] A ID de classe da função.
cTypeArgs
[in] O número de parâmetros de tipo para determinada função. Esse valor deve ser zero para funções de não-genéricas.
typeArgs
[in] Uma matriz de ClassID valores, cada um deles é um argumento da função. O valor de typeArgs pode ser NULL se cTypeArgs está definido como zero.
pFunctionID
[out] Um ponteiro para o FunctionID da função especificada.

Comentários

Chamar o GetFunctionFromTokenAndTypeArgs método com um mdMethodRef metadados, em vez de um mdMethodDef o token de metadados pode ter resultados imprevisíveis. Os chamadores devem resolver o mdMethodRef para um mdMethodDef ao passar o proprietário.

Se a função já não está carregada, chamada GetFunctionFromTokenAndTypeArgs fará com que o carregamento ocorra, que é uma operação perigosa em muitos contextos. Por exemplo, chamar este método durante o carregamento de módulos ou tipos pode levar a um loop infinito conforme o tempo de execução tenta carregar circularmente de coisas.

Em geral, use de GetFunctionFromTokenAndTypeArgs é desencorajado. Se estiverem interessados em eventos para uma função específica o geradores de perfis, deve armazenar a ModuleID e mdMethodDef de função e o uso ICorProfilerInfo2::GetFunctionInfo2 para verificar se um determinado FunctionID é a função desejada.