Metode IDebugSymbols2::GetScopeSymbolGroup (dbgeng.h)

Artikel
02/26/2024

Metode GetScopeSymbolGroup mengembalikan grup simbol yang berisi simbol dalam cakupan target saat ini.

Sintaks

HRESULT GetScopeSymbolGroup(
  [in]           ULONG               Flags,
  [in, optional] PDEBUG_SYMBOL_GROUP Update,
  [out]          PDEBUG_SYMBOL_GROUP *Symbols
);

Parameter

[in] Flags

Menentukan bit-set yang digunakan untuk menentukan simbol mana yang akan disertakan dalam grup simbol. Untuk menyertakan semua simbol, atur Bendera ke DEBUG_SCOPE_GROUP_ALL. Bendera bit berikut menentukan simbol mana yang disertakan.

Bendera	Deskripsi
DEBUG_SCOPE_GROUP_ARGUMENTS	Sertakan argumen fungsi untuk cakupan saat ini.
DEBUG_SCOPE_GROUP_LOCALS	Sertakan variabel lokal untuk cakupan saat ini.

[in, optional] Update

Menentukan grup simbol yang dibuat sebelumnya yang akan diperbarui untuk mencerminkan cakupan saat ini. Jika Update adalah NULL, objek antarmuka grup simbol baru dibuat.

[out] Symbols

Menerima objek antarmuka grup simbol untuk cakupan saat ini. Untuk detail tentang antarmuka ini, lihat IDebugSymbolGroup

Nilai kembali

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

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.

Keterangan

Parameter Pembaruan memungkinkan pembaruan yang efisien saat melangkah melalui kode. Alih-alih membuat dan mengisi grup simbol baru, grup simbol lama dapat diperbarui.

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