Compartilhar via

Método ICorProfilerCallback::ObjectReferences

Notifica o criador de perfil sobre objetos na memória que estão sendo referenciados pelo objeto especificado.

Sintaxe

HRESULT ObjectReferences(  
    [in]  ObjectID objectId,  
    [in]  ClassID  classId,  
    [in]  ULONG    cObjectRefs,  
    [in, size_is(cObjectRefs)] ObjectID objectRefIds[] );

Parâmetros

objectId
[in] A ID do objeto que está referenciando objetos.

classId
[in] A ID da classe da qual o objeto especificado é uma instância.

cObjectRefs
[in] O número de objetos referenciados pelo objeto especificado (ou seja, o número de elementos na matriz objectRefIds).

objectRefIds
[in] Uma matriz de IDs de objetos que estão sendo referenciados por objectId.

Comentários

O método ObjectReferences é chamado para cada objeto restante no heap após a conclusão de uma coleta de lixo. Se o criador de perfil retornar um erro desse retorno de chamada, os serviços de criação de perfil interromperão a invocação desse retorno de chamada até a próxima coleta de lixo.

O retorno de chamada ObjectReferences pode ser usado em conjunto com o retorno de chamada ICorProfilerCallback::RootReferences para criar um grafo de referência de objeto completo para o runtime. O CLR (Common Language Runtime) garante que cada referência de objeto seja relatada apenas uma vez pelo método ObjectReferences.

As IDs de objeto retornadas por ObjectReferences não são válidas durante o retorno de chamada em si, pois a coleta de lixo pode estar no meio da movimentação de objetos. Portanto, os criadores de perfis não devem tentar inspecionar objetos durante uma chamada ObjectReferences. Quando ICorProfilerCallback2::GarbageCollectionFinished é chamado, a coleta de lixo é concluída e a inspeção pode ser feita com segurança.

Um nulo ClassId indica que objectId tem um tipo que está sendo descarregado.

Requisitos

Plataformas: confira Requisitos do sistema.

Cabeçalho: CorProf.idl, CorProf.h

Biblioteca: CorGuids.lib

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

Confira também

  • Last updated on