Metode IDebugClient2::GetRunningProcessSystemIdByExecutableName (dbgeng.h)

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.

Mengembalikan nilai

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.

Keterangan

Metode ini hanya tersedia untuk penelusuran kesalahan mode pengguna langsung.

Untuk informasi selengkapnya tentang membuat dan melampirkan ke target mode pengguna langsung, lihat Target User-Mode Langsung.

Persyaratan

   
Target Platform Desktop
Header dbgeng.h (termasuk Dbgeng.h)

Lihat juga

AttachProcess

ConnectProcessServer

CreateProcessAndAttach2

GetRunningProcessDescription

GetRunningProcessSystemIds

IDebugClient

IDebugClient2

IDebugClient3

IDebugClient4

IDebugClient5