Metode IDebugEventCallbacks::CreateProcess (dbgeng.h)

Artikel
08/07/2023

Metode panggilan balik CreateProcess dipanggil oleh mesin ketika peristiwa debugging proses buat terjadi di target.

Sintaks

HRESULT CreateProcess(
  [in]           ULONG64 ImageFileHandle,
  [in]           ULONG64 Handle,
  [in]           ULONG64 BaseOffset,
  [in]           ULONG   ModuleSize,
  [in, optional] PCSTR   ModuleName,
  [in, optional] PCSTR   ImageName,
  [in]           ULONG   CheckSum,
  [in]           ULONG   TimeDateStamp,
  [in]           ULONG64 InitialThreadHandle,
  [in]           ULONG64 ThreadDataOffset,
  [in]           ULONG64 StartOffset
);

Parameter

[in] ImageFileHandle

Menentukan handel ke file gambar proses. Jika informasi ini tidak tersedia, ImageFileHandle akan menjadi NULL.

[in] Handle

Menentukan handel ke proses. Parameter ini sesuai dengan bidang hProcess dalam struktur CREATE_PROCESS_DEBUG_INFO. Jika informasi ini tidak tersedia, ImageFileHandle akan menjadi NULL.

[in] BaseOffset

Menentukan alamat dasar gambar proses yang dapat dieksekusi di ruang alamat memori target. Jika informasi ini tidak tersedia, BaseOffset akan menjadi NULL.

[in] ModuleSize

Menentukan ukuran gambar proses yang dapat dieksekusi dalam byte. Jika informasi ini tidak tersedia, ModuleSize akan menjadi nol.

[in, optional] ModuleName

Menentukan nama modul yang disederhanakan yang digunakan oleh mesin debugger. Dalam kebanyakan kasus, ini cocok dengan nama file gambar yang tidak termasuk ekstensi. Jika informasi ini tidak tersedia, ModuleName akan menjadi NULL.

[in, optional] ImageName

Menentukan nama file executable-image proses, yang dapat menyertakan jalur. Jika informasi ini tidak tersedia, ImageName akan menjadi NULL.

[in] CheckSum

Menentukan checksum gambar proses yang dapat dieksekusi. Jika informasi ini tidak tersedia, CheckSum akan menjadi nol.

[in] TimeDateStamp

Menentukan stempel waktu dan tanggal file executable-image proses. Jika informasi ini tidak tersedia, TimeDateStamp akan menjadi nol.

[in] InitialThreadHandle

Menentukan handel ke utas awal proses. Parameter ini sesuai dengan bidang hThread dalam struktur CREATE_PROCESS_DEBUG_INFO. Jika informasi ini tidak tersedia, InitialThreadHandle akan menjadi NULL.

[in] ThreadDataOffset

Menentukan blok data yang dikelola sistem operasi untuk utas ini. Data aktual dalam blok ini khusus sistem operasi. Jika informasi ini tidak tersedia, ThreadDataOffset akan menjadi NULL.

[in] StartOffset

Menentukan alamat awal utas di ruang alamat virtual proses. Jika informasi ini tidak tersedia, StartOffset akan menjadi NULL.

Nilai kembali

Metode ini mengembalikan nilai DEBUG_STATUS_XXX , yang menunjukkan bagaimana eksekusi target harus dilanjutkan setelah mesin memproses peristiwa ini. Untuk detail tentang cara mesin memperlakukan nilai ini, lihat Memantau Peristiwa.

Keterangan

Metode ini hanya dipanggil oleh mesin jika bendera DEBUG_EVENT_CREATE_PROCESS diatur dalam masker yang dikembalikan oleh IDebugEventCallbacks::GetInterestMask.

Untuk informasi selengkapnya tentang menangani peristiwa, lihat Memantau Peristiwa. Untuk informasi tentang utas, lihat Utas dan Proses.

Persyaratan

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