Metodo IGetAppTrackerData::GetApplicationProcesses (comsvcs.h)

Recupera informazioni di riepilogo per tutti i processi che ospitano applicazioni COM+ o per un subset specificato di questi processi.

Sintassi

HRESULT GetApplicationProcesses(
  [in]  REFGUID                   PartitionId,
  [in]  REFGUID                   ApplicationId,
  [in]  DWORD                     Flags,
  [out] ULONG                     *NumApplicationProcesses,
  [out] ApplicationProcessSummary **ApplicationProcesses
);

Parametri

[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 dall'enumerazione GetAppTrackerDataFlags per filtrare i risultati e selezionare i dati restituiti. Sono supportati i flag seguenti: GATD_INCLUDE_PROCESS_EXE_NAME, GATD_INCLUDE_LIBRARY_APPS, GATD_INCLUDE_SWC. Per altre informazioni, vedere le osservazioni riportate di seguito.

[out] NumApplicationProcesses

Al ritorno, il numero di processi che corrispondono ai criteri di filtro specificati da PartitionId, ApplicationId e Flag.

[out] ApplicationProcesses

In caso di ritorno, una matrice di strutture ApplicationProcessSummary per i processi corrispondenti.

Valore restituito

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

Commenti

I parametri PartitionId, ApplicationId e Flag possono essere usati per specificare criteri di filtro se il chiamante vuole solo informazioni su un subset di processi monitorati.

Se né GATD_INCLUDE_LIBRARY_APPS né GATD_INCLUDE_SWC sono impostati in Flag, i risultati includono solo istanze dell'applicazione server COM+. Il parametro ApplicationId può essere usato per selezionare istanze di un'applicazione server COM+ specifica e il parametro PartitionId per le applicazioni server COM+ da una partizione specifica.

Se vengono impostati GATD_INCLUDE_LIBRARY_APPS o GATD_INCLUDE_SWC, i risultati includono anche processi che ospitano rispettivamente applicazioni di libreria COM+ o Servizi senza componenti. In questi casi, i processi di filtro ApplicationId e PartitionId basati su tutte le applicazioni (dei tipi richiesti) che il processo ospita. Se un processo include almeno un'applicazione che soddisfa i criteri, verrà inclusa nei risultati.

Si supponga, ad esempio, che le applicazioni COM+ seguenti siano installate:

• AppX è un'applicazione server in PartitionA.
• AppY è un'applicazione di libreria in PartitionA.
• AppZ è un'applicazione server in PartitionB.

• Verrà inclusa un'istanza di AppX.
• Verrà incluso un processo client che ha creato componenti da AppY.
• Un'istanza di AppZ contenente nessun altro componente COM+ non verrà inclusa perché AppZ non è nella partizione specificata da PartitionId.
• Tuttavia, se esiste un'altra istanza di AppZ, ma che ha anche creato componenti da AppY, questo processo verrà incluso anche se l'applicazione server non è nella partizione specificata da PartitionId. Questo processo non verrà incluso se GATD_INCLUDE_LIBRARY_APPS non è stato impostato.

Requisiti

Vedi anche

IGetAppTrackerData