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

  • Artigo

Recupera informações detalhadas sobre um único processo que hospeda aplicativos COM+.

Sintaxe

HRESULT GetApplicationProcessDetails(
  [in]            REFGUID                       ApplicationInstanceId,
  [in]            DWORD                         ProcessId,
  [in]            DWORD                         Flags,
  [out, optional] ApplicationProcessSummary     *Summary,
  [out, optional] ApplicationProcessStatistics  *Statistics,
  [out, optional] ApplicationProcessRecycleInfo *RecycleInfo,
  [out, optional] BOOL                          *AnyComponentsHangMonitored
);

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 o parâmetro ApplicationInstanceId for usado para seleção.

[in] Flags

Uma combinação de sinalizadores da enumeração GetAppTrackerDataFlags que especificam quais dados devem ser retornados. Há suporte para os seguintes sinalizadores: GATD_INCLUDE_PROCESS_EXE_NAME (se estiver recuperando um resumo).

[out, optional] Summary

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

[out, optional] Statistics

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

[out, optional] RecycleInfo

No retorno, uma estrutura ApplicationProcessRecycleInfo com detalhes de reciclagem para o processo. Este parâmetro pode ser NULL.

[out, optional] AnyComponentsHangMonitored

No retorno, indica se algum componente no processo está configurado para monitoramento de travamento. Este parâmetro pode ser NULL.

Retornar valor

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.

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 processo passando valores não NULL para Summary, Statistics, RecycleInfo ou AnyComponentsHangMonitored. Pelo menos um desses parâmetros deve ser não NULL.

Requisitos

Requisito Valor
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