Método ICorProfilerCallback::ObjectReferences
Notifica o criador de perfil sobre objetos na memória referenciados pelo objeto especificado.
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 faz referência a objetos.classId
[in] A ID da classe que o objeto especificado for uma instância do.cObjectRefs
[in] O número de objetos referenciados pelo objeto especificado (ou seja, o número de elementos no objectRefIds matriz).objectRefIds
[in] Uma matriz de identificações de objetos que estão sendo referenciados por objectId.
Comentários
The ObjectReferences método é chamado para cada objeto restante no heap após um lixo coleção foi concluída. Se o criador de perfil retorna um erro desse retorno de chamada, os serviços de criação de perfil irão interromper invocar esse retorno de chamada até o próximo lixo coleção.
The ObjectReferences retorno de chamada pode ser usado em conjunto com o ICorProfilerCallback::RootReferences retorno de chamada para criar um gráfico de referência de objeto completo para o tempo de execução. O common linguagem tempo de execução (CLR) garante que cada referência de objeto for reportada apenas uma vez pelo ObjectReferences método.
O objeto retornados por IDsObjectReferences inválido são válido durante o retorno de chamada, pois o lixo coleção pode estar no meio de movimentação de objetos. Portanto, geradores de perfis não devem tentar inspecionar objetos durante uma ObjectReferences telefonar. Quando ICorProfilerCallback2::GarbageCollectionFinished é chamado, a coleta de lixo for concluída e inspeção pode ser feita com segurança.
Requisitos
Plataformas: See Requisitos de sistema do .NET framework.
Cabeçalho: CorProf.idl
Biblioteca: CorGuids.lib
.NET Framework Versions: 3.5 SP1, 3,5, 3.0 SP1, 3.0, 2.0 SP1, 2.0