Metode IDebugRegisters2::SetValue (dbgeng.h)

Artikel
02/26/2024

Metode SetValue menetapkan nilai salah satu register target.

Sintaks

HRESULT SetValue(
  [in] ULONG        Register,
  [in] PDEBUG_VALUE Value
);

Parameter

[in] Register

Menentukan indeks register yang nilainya akan ditetapkan.

[in] Value

Menentukan nilai untuk mengatur register. Lihat DEBUG_VALUE untuk deskripsi jenis parameter ini.

Nilai kembali

Daftar ini tidak berisi semua kesalahan yang mungkin terjadi. Untuk daftar kemungkinan kesalahan, lihat Nilai HRESULT.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
E_UNEXPECTED	Target tidak dapat diakses, atau register tidak dapat diakses.
E_INVALIDARG	Nilai Register lebih besar dari jumlah register pada komputer target.

Keterangan

Mesin melakukan yang terbaik untuk memaksa nilai Nilai ke dalam jenis register; paksaan ini sama dengan yang dilakukan oleh CoerceValue. Jika nilainya lebih besar dari apa yang dapat ditahan oleh register, bit yang paling tidak signifikan akan dihilangkan. Konversi floating-point dan bilangan bulat juga akan dilakukan jika perlu.

Ketika subregister diubah, register yang berisinya juga diubah.

Untuk mengatur nilai beberapa register, gunakan metode SetValues sebagai gantinya.

Untuk gambaran umum antarmuka IDebugRegisters dan metode terkait pendaftaran lainnya, lihat Mendaftar.