Metode IDebugClient5::GetRunningProcessDescription (dbgeng.h)

Artikel
02/23/2024

Metode GetRunningProcessDescription mengembalikan deskripsi proses yang mencakup nama gambar yang dapat dieksekusi, nama layanan, nama paket MTS, dan baris perintah.

Sintaks

HRESULT GetRunningProcessDescription(
  [in]            ULONG64 Server,
  [in]            ULONG   SystemId,
  [in]            ULONG   Flags,
  [out, optional] PSTR    ExeName,
  [in]            ULONG   ExeNameSize,
  [out, optional] PULONG  ActualExeNameSize,
  [out, optional] PSTR    Description,
  [in]            ULONG   DescriptionSize,
  [out, optional] PULONG  ActualDescriptionSize
);

Parameter

[in] Server

Menentukan server proses yang akan dikueri untuk deskripsi proses. Jika Server nol, mesin akan meminta informasi tentang proses lokal secara langsung.

[in] SystemId

Menentukan ID proses proses yang deskripsinya diinginkan.

[in] Flags

Menentukan set bit yang berisi opsi yang memengaruhi perilaku metode ini. Bendera dapat berisi bendera bit berikut:

Bendera	Deskripsi
DEBUG_PROC_DESC_NO_PATHS	Hanya mengembalikan nama file tanpa nama jalur.
DEBUG_PROC_DESC_NO_SERVICES	Jangan mencari nama layanan.
DEBUG_PROC_DESC_NO_MTS_PACKAGES	Jangan mencari nama paket MTS.
DEBUG_PROC_DESC_NO_COMMAND_LINE	Jangan mengambil baris perintah.

[out, optional] ExeName

Menerima nama file yang dapat dieksekusi yang digunakan untuk memulai proses. Jika ExeNameNULL, informasi ini tidak dikembalikan.

[in] ExeNameSize

Menentukan ukuran dalam karakter buffer ExeNameSize. Ukuran ini mencakup ruang untuk karakter yang mengakhiri '\0'.

[out, optional] ActualExeNameSize

Menerima ukuran dalam karakter nama file yang dapat dieksekusi. Ukuran ini mencakup ruang untuk karakter yang mengakhiri '\0'. Jika ExeNameSizeNULL, informasi ini tidak dikembalikan.

[out, optional] Description

Menerima informasi tambahan tentang proses ini, termasuk nama layanan, nama paket MTS, dan baris perintah. Jika DeskripsiNULL, informasi ini tidak dikembalikan.

[in] DescriptionSize

Menentukan ukuran dalam karakter Deskripsi buffer. Ukuran ini mencakup ruang untuk karakter yang mengakhiri '\0'.

[out, optional] ActualDescriptionSize

Menerima ukuran dalam karakter informasi tambahan. Ukuran ini mencakup ruang untuk karakter yang mengakhiri '\0'. Jika ActualDescriptionSizeADALAH NULL, informasi ini tidak dikembalikan.

Nilai kembali

Metode ini juga dapat mengembalikan nilai kesalahan. Lihat Mengembalikan Nilai untuk detail selengkapnya.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
S_FALSE	Metode berhasil. Namun, ExeNameSize atau DescriptionSize lebih kecil dari ukuran string masing-masing dan string dipotong agar pas di dalam buffer.