Metode IGetAppTrackerData::GetApplicationsInProcess (comsvcs.h)

Artikel
02/26/2024

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

Sintaks

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

Parameter

[in] ApplicationInstanceId

GUID instans aplikasi yang secara unik mengidentifikasi proses yang dilacak untuk dipilih, atau GUID_NULL jika parameter ProcessId akan digunakan untuk pemilihan sebagai gantinya.

[in] ProcessId

ID proses yang mengidentifikasi proses yang akan dipilih, atau 0 jika ApplicationInstanceId akan digunakan untuk pilihan sebagai gantinya.

[in] PartitionId

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

[in] Flags

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

[out] NumApplicationsInProcess

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

[out] Applications

Sebagai gantinya, array struktur ApplicationSummary untuk aplikasi 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 Aplikasi .
S_FALSE	Metode berhasil diselesaikan, tetapi tidak ada proses yang cocok dengan kriteria filter.
COMADMIN_E_APP_NOT_RUNNING	Proses yang ditentukan tidak ada, atau tidak menghosting aplikasi COM+ yang dilacak.

Keterangan

Proses dapat dipilih oleh ID instans aplikasi atau ID prosesnya, tetapi tidak keduanya. Pemilihan berdasarkan ID instans aplikasi umumnya lebih disukai, karena ID proses dapat digunakan kembali setelah proses berakhir. Namun, pemilihan menurut ID proses mungkin berguna jika Anda mendapatkan ID proses dari beberapa sumber lain, seperti argumen baris perintah ke program Anda.

Jika tidak GATD_INCLUDE_LIBRARY_APPS atau GATD_INCLUDE_SWC diatur dalam Bendera, hanya aplikasi server COM+ yang disertakan dalam hasilnya. Jika GATD_INCLUDE_LIBRARY_APPS diatur, aplikasi pustaka COM+ dalam prosesnya, jika ada, juga disertakan. Jika GATD_INCLUDE_SWC diatur, dan prosesnya menghosting satu atau beberapa konteks Layanan Tanpa Komponen, hasilnya juga akan menyertakan entri aplikasi semu tunggal dengan ringkasan konteks SWC.

Persyaratan

Persyaratan	Nilai
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