IDebugReference2

Antarmuka ini mewakili referensi ke properti bingkai tumpukan atau beberapa properti lainnya.

Catatan

IDebugReference2 dicadangkan untuk digunakan di masa mendatang, dan semua metodenya harus mengembalikan E_NOTIMPL.

Sintaks

IDebugReference2 : IUnknown

Catatan untuk Pelaksana

DE mengimplementasikan antarmuka ini untuk mewakili referensi ke jenis nilai tertentu. Misalnya, nilai bisa menjadi nilai numerik sebagai hasil dari evaluasi ekspresi, konteks memori yang digunakan untuk menampilkan memori, atau daftar register dan nilainya.

Catatan untuk Penelepon

Panggil GetReference untuk mendapatkan antarmuka ini. GetParent dan GetDerivedMostReference juga mengembalikan antarmuka ini.

Metode dalam Urutan Vtable

Tabel berikut memperlihatkan metode IDebugReference2.

Metode	Deskripsi
GetReferenceInfo	Mendapatkan struktur DEBUG_REFERENCE_INFO yang menjelaskan referensi ini.
SetValueAsString	Mengatur nilai referensi ini dari string.
SetValueAsReference	Mengatur nilai referensi ini dari referensi lain.
EnumChildren	Menghitung turunan referensi ini.
GetParent	Mendapatkan induk referensi ini.
GetDerivedMostReference	Mendapatkan referensi yang paling turunan dari referensi ini.
GetMemoryBytes	Mendapatkan byte memori yang dirujuk oleh referensi ini.
GetMemoryContext	Mendapatkan konteks memori untuk referensi ini.
GetSize	Mendapatkan ukuran, dalam byte, dari referensi ini.
SetReferenceType	Menyetel tipe referensi ini.
Bandingkan	Membandingkan referensi ini dengan referensi lain.

Keterangan

Catatan

Penggunaan "properti" ini tidak boleh dikacaukan dengan yang berarti variabel anggota kelas, meskipun IDebugReference2 dapat mewakili entitas tersebut.

IDebugProperty2 mewakili properti, sementara IDebugReference2 mewakili referensi ke properti, biasanya referensi ke objek dalam program yang sedang di-debug.

Perbedaan utama antara properti dan referensi adalah bahwa properti mengacu pada instans objek bernama, sementara referensi mengacu pada instans yang tidak disebutkan namanya. Misalnya, properti dapat merujuk ke objek dalam timbunan program dengan "a.b". Properti lain dapat merujuk ke objek yang sama dengan "c.d". Cara merujuk ke properti ini mengharuskan atau "a.b" "c.d" berada dalam cakupan. Referensi ke objek yang sama ini tidak bernama; objek dapat disebut selama memori untuk objek tersebut valid.

Antarmuka IDebugProperty2 dapat dianggap sebagai nilai dengan nama, jenis, dan alamat. Di IDebugReference2sisi lain, dapat dianggap sebagai jenis dan alamat.

Persyaratan

Header: msdbg.h

Namespace: Microsoft.VisualStudio.Debugger.Interop

Rakitan: Microsoft.VisualStudio.Debugger.Interop.dll

Bagikan melalui