Metodo IGetAppTrackerData::GetComponentDetails (comsvcs.h)

Recupera informazioni dettagliate su un singolo componente COM+ ospitato in un processo.

Sintassi

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

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 ApplicationInstanceId verrà usato per la selezione.

[in] Clsid

Valore CLSID del componente.

[in] Flags

Combinazione di flag dall'enumerazione GetAppTrackerDataFlags per selezionare i dati restituiti. I flag seguenti sono supportati: GATD_INCLUDE_CLASS_NAME (se si recupera un riepilogo), GATD_INCLUDE_APPLICATION_NAME (se si recupera un riepilogo).

[out] Summary

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

[out] Statistics

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

[out] HangMonitorInfo

In caso di ritorno, una struttura ComponentHangMonitorInfo con configurazione di monitoraggio in blocco per il componente. Questo parametro può essere NULL.

Valore restituito

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

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 componente passando valori non NULL per Riepilogo, Statistiche o HangMonitorInfo. Almeno uno di questi parametri deve essere diverso da NULL.

Requisiti

Vedi anche

IGetAppTrackerData