Metodo IGetAppTrackerData::GetApplicationsInProcess (comsvcs.h)

Articolo
08/22/2023

Recupera le informazioni di riepilogo per tutte le applicazioni COM+ ospitate in un singolo processo o per un subset specificato di queste applicazioni.

Sintassi

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

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

[in] PartitionId

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

[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_APPLICATION_NAME. Per altre informazioni, vedere la sezione Osservazioni di seguito.

[out] NumApplicationsInProcess

In caso di restituzione, il numero di applicazioni nel processo che soddisfano i criteri di filtro specificati da PartitionId e Flags.

[out] Applications

In caso di restituzione, matrice di strutture ApplicationSummary per le applicazioni 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 Applications .
S_FALSE	Il metodo è stato completato correttamente, ma non sono stati elaborati i criteri di filtro corrispondenti.
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 né GATD_INCLUDE_LIBRARY_APPS né GATD_INCLUDE_SWC sono impostati in Flag, nei risultati viene inclusa solo l'applicazione server COM+. Se GATD_INCLUDE_LIBRARY_APPS è impostato, vengono incluse anche le applicazioni di libreria COM+ nel processo, se presenti. Se GATD_INCLUDE_SWC è impostato e il processo ospita uno o più contesti Services Without Components, i risultati includeranno anche una singola voce pseudo-applicazione con un riepilogo dei contesti SWC.

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