Metode IDebugClient2::CreateProcessAndAttach (dbgeng.h)

Artikel
02/23/2024

Metode CreateProcessAndAttach membuat proses dari baris perintah tertentu, lalu melampirkan ke proses mode pengguna lain. Proses yang dibuat ditangguhkan dan hanya diizinkan untuk dijalankan ketika lampiran telah selesai. Ini memungkinkan sinkronisasi kasar saat men-debug proses klien dan server.

Sintaks

HRESULT CreateProcessAndAttach(
  [in]           ULONG64 Server,
  [in, optional] PSTR    CommandLine,
  [in]           ULONG   CreateFlags,
  [in]           ULONG   ProcessId,
  [in]           ULONG   AttachFlags
);

Parameter

[in] Server

Menentukan server proses yang akan digunakan untuk melampirkan ke proses. Jika Server nol, mesin akan terhubung ke proses lokal tanpa menggunakan server proses.

[in, optional] CommandLine

Menentukan baris perintah yang akan dijalankan untuk membuat proses baru. Jika CommandLineNULL, maka tidak ada proses yang dibuat dan metode ini melekat pada proses yang ada, seperti yang dilakukan AttachProcess .

[in] CreateFlags

Menentukan bendera yang akan digunakan saat membuat proses. Untuk detail tentang bendera ini, lihat DEBUG_CREATE_PROCESS_OPTIONS. CreateFlags.

[in] ProcessId

Menentukan ID proses dari proses target yang akan dilampirkan oleh debugger. Jika ProcessId nol, debugger akan melampirkan ke proses yang dibuatnya dari CommandLine.

[in] AttachFlags

Menentukan bendera yang mengontrol bagaimana debugger dilampirkan ke proses target. Untuk detail tentang bendera ini, lihat DEBUG_ATTACH_XXX.

Nilai kembali

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

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.

Keterangan

Metode ini hanya tersedia untuk penelusuran kesalahan mode pengguna langsung.

Jika CommandLine bukan NULL dan ProcessId bukan nol, maka mesin akan membuat proses dalam status ditangguhkan. Mesin akan melanjutkan proses yang baru dibuat ini setelah berhasil terhubung ke proses yang ditentukan dalam ProcessId.

Catatan Mesin tidak sepenuhnya melekat pada proses sampai metode WaitForEvent telah dipanggil. Hanya setelah proses menghasilkan peristiwa -- misalnya, peristiwa buat-proses -- apakah itu tersedia di sesi debugger.

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