Metode IDebugSymbols2::SetScope (dbgeng.h)

Artikel
02/23/2024

Metode SetScope mengatur cakupan saat ini.

Sintaks

HRESULT SetScope(
  [in]           ULONG64            InstructionOffset,
  [in, optional] PDEBUG_STACK_FRAME ScopeFrame,
  [in, optional] PVOID              ScopeContext,
  [in]           ULONG              ScopeContextSize
);

Parameter

[in] InstructionOffset

Menentukan lokasi dalam ruang alamat virtual proses untuk instruksi cakupan saat ini. Ini hanya digunakan jika ScopeFrame dan ScopeContext adalah NULL; jika tidak, itu diabaikan.

[in, optional] ScopeFrame

Menentukan bingkai tumpukan cakupan. Untuk informasi tentang struktur ini, lihat DEBUG_STACK_FRAME.

[in, optional] ScopeContext

Menentukan konteks utas cakupan. Jenis konteks utas adalah struktur CONTEXT untuk prosesor efektif target. Buffer ScopeContext harus cukup besar untuk menahan struktur ini. Jika ScopeContext adalah NULL, konteks register saat ini digunakan sebagai gantinya.

[in] ScopeContextSize

Menentukan ukuran buffer ScopeContext.

Nilai kembali

Metode ini juga dapat mengembalikan nilai kesalahan. Lihat Mengembalikan Nilai untuk detail selengkapnya.

Menampilkan kode	Deskripsi
S_OK	Cakupan yang diidentifikasi oleh InstructionOffset, ScopeFrame, dan ScopeContext sama dengan cakupan lama.
S_FALSE	Cakupan telah berubah.

Keterangan

Jika hanya InstructionOffset yang disediakan, cakupan dapat digunakan untuk mencari nama simbol; namun, nilai simbol-simbol ini tidak akan tersedia.

Untuk mengatur cakupan ke status sebelumnya, ScopeContext harus disediakan. Ini tidak selalu diperlukan (misalnya, jika Anda hanya ingin mengakses simbol dan bukan register). Untuk mengatur cakupan ke bingkai pada tumpukan saat ini, SetScopeFrameByIndex dapat digunakan.

Untuk informasi selengkapnya tentang cakupan, lihat Cakupan dan Grup Simbol.