Metode IGetAppTrackerData::GetComponentDetails (comsvcs.h)

Artikel
08/22/2023

Mengambil informasi terperinci tentang satu komponen COM+ yang dihosting dalam proses.

Sintaks

HRESULT GetComponentDetails(
  [in]  REFGUID                  ApplicationInstanceId,
  [in]  DWORD                    ProcessId,
  [in]  REFCLSID                 Clsid,
  [in]  DWORD                    Flags,
  [out] ComponentSummary         *Summary,
  [out] ComponentStatistics      *Statistics,
  [out] ComponentHangMonitorInfo *HangMonitorInfo
);

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] Clsid

CLSID komponen.

[in] Flags

Kombinasi bendera dari enumerasi GetAppTrackerDataFlags untuk memilih data mana yang dikembalikan. Bendera berikut didukung: GATD_INCLUDE_CLASS_NAME (jika mengambil ringkasan), GATD_INCLUDE_APPLICATION_NAME (jika mengambil ringkasan).

[out] Summary

Saat kembali, struktur ComponentSummary dengan informasi ringkasan untuk komponen. Parameter ini bisa NULL.

[out] Statistics

Saat kembali, struktur ComponentStatistics dengan statistik untuk komponen. Parameter ini bisa NULL.

[out] HangMonitorInfo

Saat kembali, struktur ComponentHangMonitorInfo dengan konfigurasi pemantauan hang untuk komponen. Parameter ini bisa NULL.

Mengembalikan nilai

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.
COMADMIN_E_OBJECT_DOES_NOT_EXIST	Komponen yang ditentukan tidak ada dalam proses yang ditentukan.

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 komponen dengan meneruskan nilai non-NULL untuk Ringkasan, Statistik, atau HangMonitorInfo. Setidaknya salah satu parameter ini harus non-NULL.

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