Metode IDebugClient4::CreateProcessWide (dbgeng.h)

Artikel
02/23/2024

Metode CreateProcessWide membuat proses dari baris perintah yang ditentukan.

Sintaks

HRESULT CreateProcessWide(
  [in] ULONG64 Server,
  [in] PWSTR   CommandLine,
  [in] ULONG   CreateFlags
);

Parameter

[in] Server

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

[in] CommandLine

Menentukan baris perintah yang akan dijalankan untuk membuat proses baru. Metode CreateProcessWide mungkin mengubah konten string yang Anda berikan dalam parameter ini. Oleh karena itu, parameter ini tidak dapat menjadi penunjuk ke memori baca-saja (seperti variabel const atau string literal). Meneruskan string konstanta dalam parameter ini dapat menyebabkan pelanggaran akses.

[in] CreateFlags

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

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 CreateFlags berisi salah satu bendera DEBUG_PROCESS atau DEBUG_ONLY_THIS_PROCESS, mesin juga melekat pada proses yang baru dibuat. Perilaku ini mirip dengan CreateProcessAndAttach2 ketika argumennya ProcessId diatur ke nol.

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