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

  • Artigo

Recupera informações resumidas para todos os aplicativos COM+ hospedados em um único processo ou para um subconjunto especificado desses aplicativos.

Sintaxe

HRESULT GetApplicationsInProcess(
  [in]  REFGUID            ApplicationInstanceId,
  [in]  DWORD              ProcessId,
  [in]  REFGUID            PartitionId,
  [in]  DWORD              Flags,
  [out] ULONG              *NumApplicationsInProcess,
  [out] ApplicationSummary **Applications
);

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] PartitionId

Uma ID de partição para filtrar resultados ou GUID_NULL para todas as partições.

[in] Flags

Uma combinação de sinalizadores da enumeração GetAppTrackerDataFlags para filtrar os resultados e selecionar quais dados são retornados. Há suporte para os seguintes sinalizadores: GATD_INCLUDE_LIBRARY_APPS, GATD_INCLUDE_SWC GATD_INCLUDE_APPLICATION_NAME. Consulte Comentários abaixo para obter mais informações.

[out] NumApplicationsInProcess

No retorno, o número de aplicativos no processo que correspondem aos critérios de filtro especificados por PartitionId e Flags.

[out] Applications

No retorno, uma matriz de estruturas ApplicationSummary para os aplicativos correspondentes.

Retornar valor

Esse método pode retornar os valores de retorno 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 êxito e os resultados estão no parâmetro Applications .
S_FALSE
 O método foi concluído com êxito, mas não houve processos que correspondessem aos critérios de filtro.
COMADMIN_E_APP_NOT_RUNNING
 O processo especificado não existe ou não está hospedando nenhum aplicativo COM+ rastreado.

Comentários

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

Se nem GATD_INCLUDE_LIBRARY_APPS nem GATD_INCLUDE_SWC estiverem definidos em Sinalizadores, somente o aplicativo de servidor COM+ será incluído nos resultados. Se GATD_INCLUDE_LIBRARY_APPS estiver definido, os aplicativos de biblioteca COM+ no processo, se houver, também serão incluídos. Se GATD_INCLUDE_SWC estiver definido e o processo estiver hospedando um ou mais contextos de Serviços Sem Componentes, os resultados também incluirão uma única entrada pseudoaplicação com um resumo dos contextos do SWC.

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