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 |
|---|---|
|
O método foi concluído com sucesso. |
|
O processo especificado não existe ou não está hospedando nenhum aplicativo COM+ acompanhado. |
|
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 |