Metode IGetAppTrackerData::GetApplicationProcesses (comsvcs.h)

Artikel
08/22/2023

Mengambil informasi ringkasan untuk semua proses yang menghosting aplikasi COM+, atau untuk subset tertentu dari proses ini.

Sintaks

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

Parameter

[in] PartitionId

ID partisi untuk memfilter hasil, atau GUID_NULL untuk semua partisi.

[in] ApplicationId

ID aplikasi untuk memfilter hasil, atau GUID_NULL untuk semua aplikasi.

[in] Flags

Kombinasi bendera dari enumerasi GetAppTrackerDataFlags untuk memfilter hasil dan untuk memilih data mana yang dikembalikan. Bendera berikut didukung: GATD_INCLUDE_PROCESS_EXE_NAME, GATD_INCLUDE_LIBRARY_APPS, GATD_INCLUDE_SWC. Lihat keterangan di bawah ini untuk informasi selengkapnya.

[out] NumApplicationProcesses

Saat dikembalikan, jumlah proses yang cocok dengan kriteria filter yang ditentukan oleh PartitionId, ApplicationId, dan Flags.

[out] ApplicationProcesses

Saat dikembalikan, array struktur ApplicationProcessSummary untuk proses yang cocok.

Nilai kembali

Metode ini dapat mengembalikan nilai pengembalian standar E_INVALIDARG dan E_OUTOFMEMORY, serta nilai berikut.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil diselesaikan dan hasilnya ada di parameter ApplicationProcesses .
S_FALSE	Metode berhasil diselesaikan, tetapi tidak ada proses yang cocok dengan kriteria filter.

Keterangan

Parameter PartitionId, ApplicationId, dan Flags dapat digunakan untuk menentukan kriteria filter jika pemanggil hanya menginginkan informasi tentang subset proses yang dilacak.

Jika tidak GATD_INCLUDE_LIBRARY_APPS atau GATD_INCLUDE_SWC diatur dalam Bendera, hasilnya hanya menyertakan instans aplikasi server COM+. Parameter ApplicationId dapat digunakan untuk memilih instans aplikasi server COM+ tertentu, dan parameter PartitionId untuk aplikasi server COM+ dari partisi tertentu.

Jika GATD_INCLUDE_LIBRARY_APPS atau GATD_INCLUDE_SWC diatur, hasilnya juga mencakup proses yang menghosting aplikasi pustaka COM+ atau konteks Layanan Tanpa Komponen. Dalam kasus ini, applicationId dan proses filter PartitionId berdasarkan semua aplikasi (dari jenis yang diminta) yang dihosting prosesnya. Jika suatu proses mencakup setidaknya satu aplikasi yang cocok dengan kriteria, proses tersebut akan disertakan dalam hasilnya.

Misalnya, bayangkan aplikasi COM+ berikut diinstal:

AppX adalah aplikasi server di PartitionA.
AppY adalah aplikasi pustaka di PartitionA.
AppZ adalah aplikasi server di PartitionB.

Jika PartitionId menentukan PartitionA, dan GATD_INCLUDE_LIBRARY_APPS diatur:

Instans AppX akan disertakan.
Proses klien yang telah membuat komponen dari AppY akan disertakan.
Instans AppZ yang tidak berisi komponen COM+ lainnya tidak akan disertakan karena AppZ tidak berada dalam partisi yang ditentukan oleh PartitionId.
Namun, jika ada instans lain dari AppZ, tetapi yang juga telah membuat komponen dari AppY, proses ini akan disertakan meskipun aplikasi server tidak berada dalam partisi yang ditentukan oleh PartitionId. Proses ini tidak akan disertakan jika GATD_INCLUDE_LIBRARY_APPS tidak ditetapkan.

Persyaratan


Klien minimum yang didukung	Windows XP dengan SP2 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 dengan SP1 [hanya aplikasi desktop]
Target Platform	Windows
Header	comsvcs.h

Lihat juga

IGetAppTrackerData

Bagikan melalui