Metodo IGetAppTrackerData::GetApplicationProcessDetails (comsvcs.h)

Articolo
08/22/2023

Recupera informazioni dettagliate su un singolo processo che ospita applicazioni COM+.

Sintassi

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
);

Parametri

[in] ApplicationInstanceId

GUID dell'istanza dell'applicazione che identifica in modo univoco il processo monitorato da selezionare o GUID_NULL se il parametro ProcessId verrà usato per la selezione.

[in] ProcessId

ID processo che identifica il processo da selezionare o 0 se il parametro ApplicationInstanceId verrà usato per la selezione.

[in] Flags

Combinazione di flag dall'enumerazione GetAppTrackerDataFlags che specificano quali dati devono essere restituiti. I flag seguenti sono supportati: GATD_INCLUDE_PROCESS_EXE_NAME (se si recupera un riepilogo).

[out, optional] Summary

In caso di restituzione, una struttura ApplicationProcessSummary con informazioni di riepilogo per il processo. Questo parametro può essere NULL.

[out, optional] Statistics

In caso di ritorno, una struttura ApplicationProcessStatistics con statistiche per il processo. Questo parametro può essere NULL.

[out, optional] RecycleInfo

In caso di restituzione, una struttura ApplicationProcessRecycleInfo con dettagli di riciclo per il processo. Questo parametro può essere NULL.

[out, optional] AnyComponentsHangMonitored

In caso di restituzione, indica se tutti i componenti del processo sono configurati per il monitoraggio degli blocchi. Questo parametro può essere NULL.

Valore restituito

Questo metodo può restituire i valori restituiti standard E_INVALIDARG e E_OUTOFMEMORY, nonché i valori seguenti.

Codice restituito	Descrizione
S_OK	Metodo completato correttamente.
COMADMIN_E_APP_NOT_RUNNING	Il processo specificato non esiste o non ospita applicazioni COM+ rilevate.

Commenti

Un processo può essere selezionato dall'ID dell'istanza dell'applicazione o dal relativo ID processo, ma non entrambi. La selezione in base all'ID dell'istanza dell'applicazione è in genere preferita, perché gli ID processo possono essere riutilizzati dopo il termine di un processo. Tuttavia, la selezione per ID processo può essere utile se si ottiene l'ID processo da un'altra origine, ad esempio un argomento della riga di comando al programma.

È possibile richiedere qualsiasi o tutte le informazioni disponibili per il processo passando valori non NULL per Riepilogo, Statistiche, Ricicloinfo o AnyComponentsHangMonitored. Almeno uno di questi parametri deve essere diverso da NULL.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP con SP2 [solo app desktop]
Server minimo supportato	Windows Server 2003 con SP1 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	comsvcs.h

Vedi anche

IGetAppTrackerData

Condividi tramite