Metode IGetAppTrackerData::GetApplicationProcessDetails (comsvcs.h)

Artikel
02/24/2024

Mengambil informasi terperinci tentang satu proses hosting aplikasi COM+.

Sintaks

HRESULT GetApplicationProcessDetails(
  [in]            REFGUID                       ApplicationInstanceId,
  [in]            DWORD                         ProcessId,
  [in]            DWORD                         Flags,
  [out, optional] ApplicationProcessSummary     *Summary,
  [out, optional] ApplicationProcessStatistics  *Statistics,
  [out, optional] ApplicationProcessRecycleInfo *RecycleInfo,
  [out, optional] BOOL                          *AnyComponentsHangMonitored
);

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 parameter ApplicationInstanceId akan digunakan untuk pilihan sebagai gantinya.

[in] Flags

Kombinasi bendera dari enumerasi GetAppTrackerDataFlags yang menentukan data mana yang akan dikembalikan. Bendera berikut didukung: GATD_INCLUDE_PROCESS_EXE_NAME (jika mengambil ringkasan).

[out, optional] Summary

Saat kembali, struktur ApplicationProcessSummary dengan informasi ringkasan untuk proses tersebut. Parameter ini bisa NULL.

[out, optional] Statistics

Saat kembali, struktur ApplicationProcessStatistics dengan statistik untuk proses tersebut. Parameter ini bisa NULL.

[out, optional] RecycleInfo

Saat kembali, struktur ApplicationProcessRecycleInfo dengan detail daur ulang untuk proses tersebut. Parameter ini bisa NULL.

[out, optional] AnyComponentsHangMonitored

Saat kembali, menunjukkan apakah ada komponen dalam proses yang dikonfigurasi untuk pemantauan macet. Parameter ini bisa NULL.

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.
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.

Anda dapat meminta salah satu atau semua informasi yang tersedia untuk proses dengan meneruskan nilai non-NULL untuk Ringkasan, Statistik, RecycleInfo, atau AnyComponentsHangMonitored. Setidaknya salah satu parameter ini harus non-NULL.

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