Metodo IGetAppTrackerData::GetComponentsInProcess (comsvcs.h)

Articolo
02/24/2024

Recupera informazioni di riepilogo per tutti i componenti COM+ ospitati in un singolo processo o per un subset specificato di questi componenti.

Sintassi

HRESULT GetComponentsInProcess(
  [in]  REFGUID          ApplicationInstanceId,
  [in]  DWORD            ProcessId,
  [in]  REFGUID          PartitionId,
  [in]  REFGUID          ApplicationId,
  [in]  DWORD            Flags,
  [out] ULONG            *NumComponentsInProcess,
  [out] ComponentSummary **Components
);

Parametri

[in] ApplicationInstanceId

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

[in] ProcessId

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

[in] PartitionId

ID di partizione per filtrare i risultati o GUID_NULL per tutte le partizioni.

[in] ApplicationId

ID applicazione per filtrare i risultati o GUID_NULL per tutte le applicazioni.

[in] Flags

Combinazione di flag dell'enumerazione GetAppTrackerDataFlags per filtrare i risultati e selezionare i dati restituiti. Sono supportati i flag seguenti: GATD_INCLUDE_LIBRARY_APPS, GATD_INCLUDE_SWC, GATD_INCLUDE_CLASS_NAME, GATD_INCLUDE_APPLICATION_NAME. Per altre informazioni, vedere la sezione Osservazioni di seguito.

[out] NumComponentsInProcess

In caso di restituzione, il numero di componenti nel processo che soddisfano i criteri di filtro specificati da PartitionId, ApplicationId e Flag.

[out] Components

In caso di restituzione, matrice di strutture ComponentSummary per i componenti corrispondenti.

Valore restituito

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

Codice restituito	Descrizione
S_OK	Il metodo è stato completato correttamente e i risultati sono nel parametro Components .
S_FALSE	Il metodo è stato completato correttamente, ma non sono presenti componenti corrispondenti ai criteri di filtro.
COMADMIN_E_APP_NOT_RUNNING	Il processo specificato non esiste o non ospita applicazioni COM+ rilevate.

Commenti

Un processo può essere selezionato dall'ID istanza dell'applicazione o dal relativo ID processo, ma non da entrambi. La selezione in base all'ID istanza dell'applicazione è in genere preferibile, perché gli ID di processo possono essere riutilizzati dopo l'interruzione 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 per il programma.

Se nei flag non sono impostati né GATD_INCLUDE_LIBRARY_APPS né GATD_INCLUDE_SWC, nei risultati vengono inclusi solo i componenti dell'applicazione server COM+. Se GATD_INCLUDE_LIBRARY_APPS è impostato, vengono inclusi anche i componenti delle applicazioni di libreria COM+ nel processo, se presenti. Se GATD_INCLUDE_SWC è impostato, i risultati includeranno anche voci per i contesti Servizi senza componenti.

Se ApplicationId viene usato per specificare un'applicazione (non è impostata su GUID_NULL), i flag GATD_INCLUDE_LIBRARY_APPS e GATD_INCLUDE_SWC non sono significativi e non sono validi per usarli. I componenti dell'applicazione specificata verranno restituiti, indipendentemente dal tipo di applicazione.

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