Metode IDebugClient5::CreateProcess2 (dbgeng.h)

Artikel
08/07/2023

Metode CreateProcess2 menjalankan perintah yang diberikan untuk membuat proses baru.

Sintaks

HRESULT CreateProcess2(
  [in]           ULONG64 Server,
  [in]           PSTR    CommandLine,
  [in]           PVOID   OptionsBuffer,
  [in]           ULONG   OptionsBufferSize,
  [in, optional] PCSTR   InitialDirectory,
  [in, optional] PCSTR   Environment
);

Parameter

[in] Server

Menentukan server proses yang akan dilampirkan 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.

[in] OptionsBuffer

Menentukan opsi pembuatan proses. OptionsBuffer adalah penunjuk ke struktur DEBUG_CREATE_PROCESS_OPTIONS .

[in] OptionsBufferSize

Menentukan ukuran buffer OptionsBuffer. Ini harus diatur ke sizeof(DEBUG_CREATE_PROCESS_OPTIONS).

[in, optional] InitialDirectory

Menentukan direktori awal untuk proses tersebut. Jika InitialDirectory adalah NULL, direktori saat ini untuk server proses digunakan.

[in, optional] Environment

Menentukan blok lingkungan untuk proses baru. Blok lingkungan terdiri dari blok string null-terminated dari string yang dihentikan null. Setiap string berbentuk:

name=value

Perhatikan bahwa dua karakter terakhir dari blok lingkungan adalah NULL: satu untuk mengakhiri string dan satu untuk mengakhiri blok.

Jika Lingkungan diatur ke NULL, proses baru mewarisi blok lingkungan server proses. Jika bendera DEBUG_CREATE_PROCESS_THROUGH_RTL diatur di OptionsBuffer, maka Lingkungan harus NULL.

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 akan melekat pada proses yang baru dibuat. Ini mirip dengan perilaku CreateProcessAndAttach2 dengan Argumen ProcessId-nya diatur ke nol.

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