Método IGetAppTrackerData::GetTrackerDataAsCollectionObject (comsvcs.h)
Recupera dados de rastreamento para todos os aplicativos COM+ na forma de um objeto de coleção.
Sintaxe
HRESULT GetTrackerDataAsCollectionObject(
[out] IUnknown **TopLevelCollection
);
Parâmetros
[out] TopLevelCollection
No retorno, a interface IUnknown para uma coleção de dados de rastreador.
Valor retornado
Esse método pode retornar os valores de retorno padrão E_INVALIDARG, E_OUTOFMEMORY e S_OK.
Comentários
Esse método destina-se principalmente a habilitar aplicativos que assinam a interface de evento IComTrackingInfoEvents para adicionar suporte para IGetAppTrackerData com alterações mínimas em seu código. O objeto retornado por esse método é idêntico ao objeto enviado em chamadas para o método IComTrackingInfoEvent::OnNewTrackingInfo dos assinantes, para que o código para navegar e analisar essa coleção possa ser reutilizado.
Os aplicativos não devem esperar que esse método retorne dados de rastreamento atualizados com mais frequência do que o intervalo de sondagem sugerido pelo servidor (consulte IGetAppTrackerData::GetSuggestedPollingInterval).
Observe que o objeto de coleção retornado por esse método não contém todos os dados de rastreamento disponíveis chamando os outros métodos. Em particular, detalhes de reciclagem e configuração de monitoramento de travamento não são fornecidos.
Requisitos
| Cliente mínimo com suporte | Windows XP com SP2 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 com SP1 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | comsvcs.h |