Método IGetAppTrackerData::GetComponentDetails (comsvcs.h)

Recupera informações detalhadas sobre um único componente COM+ hospedado em um processo.

Sintaxe

HRESULT GetComponentDetails(
  [in]  REFGUID                  ApplicationInstanceId,
  [in]  DWORD                    ProcessId,
  [in]  REFCLSID                 Clsid,
  [in]  DWORD                    Flags,
  [out] ComponentSummary         *Summary,
  [out] ComponentStatistics      *Statistics,
  [out] ComponentHangMonitorInfo *HangMonitorInfo
);

Parâmetros

[in] ApplicationInstanceId

O GUID da instância do aplicativo que identifica exclusivamente o processo rastreado a ser selecionado ou GUID_NULL se o parâmetro ProcessId será usado para seleção.

[in] ProcessId

A ID do processo que identifica o processo a ser selecionado ou 0 se ApplicationInstanceId será usado para seleção.

[in] Clsid

O CLSID do componente.

[in] Flags

Uma combinação de sinalizadores da enumeração GetAppTrackerDataFlags para selecionar quais dados são retornados. Há suporte para os seguintes sinalizadores: GATD_INCLUDE_CLASS_NAME (se estiver recuperando um resumo), GATD_INCLUDE_APPLICATION_NAME (se estiver recuperando um resumo).

[out] Summary

No retorno, uma estrutura ComponentSummary com informações resumidas para o componente. Este parâmetro pode ser NULL.

[out] Statistics

No retorno, uma estrutura ComponentStatistics com estatísticas para o componente. Este parâmetro pode ser NULL.

[out] HangMonitorInfo

No retorno, uma estrutura ComponentHangMonitorInfo com configuração de monitoramento de travamento para o componente. Este parâmetro pode ser NULL.

Valor retornado

Esse método pode retornar os valores retornados padrão E_INVALIDARG e E_OUTOFMEMORY, bem como os valores a seguir.

Código de retorno	Descrição
S_OK	O método foi concluído com sucesso.
COMADMIN_E_APP_NOT_RUNNING	O processo especificado não existe ou não está hospedando nenhum aplicativo COM+ acompanhado.
COMADMIN_E_OBJECT_DOES_NOT_EXIST	O componente especificado não existe no processo especificado.

Comentários

Um processo pode ser selecionado pela ID da instância do aplicativo ou pela ID do processo, mas não por ambos. A seleção por ID da instância do aplicativo geralmente é preferencial, pois as IDs de processo podem ser reutilizados após o término de um processo. No entanto, a seleção por ID de processo poderá ser útil se você obter a ID do processo de alguma outra origem, como um argumento de linha de comando para o programa.

Você pode solicitar qualquer ou todas as informações disponíveis para o componente passando valores não NULL para Summary, Statistics ou HangMonitorInfo. Pelo menos um desses parâmetros deve ser não NULL.

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

Confira também

IGetAppTrackerData