IDebugControl3::Execute method (dbgeng.h)

Artikel
08/07/2023

Metode Jalankan menjalankan perintah debugger yang ditentukan.

Sintaks

HRESULT Execute(
  [in] ULONG OutputControl,
  [in] PCSTR Command,
  [in] ULONG Flags
);

Parameter

[in] OutputControl

Menentukan kontrol output yang akan digunakan saat menjalankan perintah. Untuk nilai yang mungkin, lihat DEBUG_OUTCTL_XXX. Untuk informasi selengkapnya tentang output, lihat Input dan Output.

[in] Command

Menentukan string perintah yang akan dijalankan. Perintah ditafsirkan seperti yang ditik ke dalam jendela perintah debugger. String perintah ini dapat berisi beberapa perintah agar mesin dapat dijalankan. Lihat Perintah Debugger untuk referensi perintah.

[in] Flags

Menentukan bidang bit opsi eksekusi untuk perintah. Opsi default adalah mencatat perintah tetapi untuk tidak mengirimkannya ke output. Tabel berikut mencantumkan bit yang bisa diatur.

Nilai	Deskripsi
DEBUG_EXECUTE_ECHO	String perintah dikirim ke output.
DEBUG_EXECUTE_NOT_LOGGED	String perintah tidak dicatat. Ini ditimpa oleh DEBUG_EXECUTE_ECHO.
DEBUG_EXECUTE_NO_REPEAT	Jika Command adalah string kosong, jangan ulangi perintah terakhir, dan jangan simpan string perintah saat ini untuk mengulangi eksekusi nanti.

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 menjalankan string perintah yang diberikan. Jika string memiliki beberapa perintah, metode ini tidak akan kembali sampai semua perintah telah dijalankan. Jika urutan perintah melibatkan menunggu target dijalankan, metode ini dapat memakan waktu untuk diselesaikan.

Catatan Penting untuk memahami apa artinya perintah langkah untuk dijalankan. Perintah langkah memulai tindakan melangkah tetapi tidak menunggu langkah selesai. Misalnya, Anda memanggil IDebugControl::Execute dan meneruskan string perintah yang berisi satu perintah pct. Perintah pct memulai langkah ke instruksi panggilan atau pengembalian berikutnya, tetapi pct menyelesaikan eksekusinya sebelum langkah berlangsung. Akibatnya, IDebugControl::Execute mengembalikan sebelum langkah berlangsung. Perintah lacak dan jalankan ber perilaku dengan cara yang sama. Contoh perintah yang memiliki perilaku ini termasuk g, gh, ta, tb, tct, pa, dan pc.