Metode IDebugClient5::GetRunningProcessSystemIdByExecutableName (dbgeng.h)

Artikel
02/23/2024

Metode GetRunningProcessSystemIdByExecutableName mencari proses dengan nama file yang dapat dieksekusi tertentu dan mengembalikan ID prosesnya.

Sintaks

HRESULT GetRunningProcessSystemIdByExecutableName(
  [in]  ULONG64 Server,
  [in]  PCSTR   ExeName,
  [in]  ULONG   Flags,
  [out] PULONG  Id
);

Parameter

[in] Server

Menentukan server proses untuk mencari nama yang dapat dieksekusi. Jika Server nol, mesin akan mencari nama yang dapat dieksekusi di antara proses yang berjalan di komputer lokal.

[in] ExeName

Menentukan nama file yang dapat dieksekusi untuk dicari.

[in] Flags

Menentukan bit-set yang mengontrol bagaimana nama yang dapat dieksekusi cocok. Bendera berikut mungkin ada:

Bendera	Deskripsi
DEBUG_GET_PROC_FULL_MATCH	ExeName menentukan nama jalur lengkap dari nama file yang dapat dieksekusi. Jika bendera ini tidak diatur, metode ini tidak akan menggunakan nama jalur saat mencari proses.
DEBUG_GET_PROC_ONLY_MATCH	Mengharuskan hanya satu proses yang cocok dengan nama file yang dapat dieksekusi ExeName.

[out] Id

Menerima ID proses dari proses pertama yang cocok dengan ExeName.

Nilai kembali

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

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
S_FALSE	Lebih dari satu proses cocok dengan nama file yang dapat dieksekusi di ExeName, dan DEBUG_GET_PROC_ONLY_MATCH diatur dalam Bendera.
E_NOINTERFACE	Tidak ada proses yang cocok dengan nama file yang dapat dieksekusi di ExeName.