IDebugSymbols3::GetNextSymbolMatch method (dbgeng.h)

Artikel
02/26/2024

Metode GetNextSymbolMatch mengembalikan simbol berikutnya yang ditemukan dalam pencarian simbol.

Sintaks

HRESULT GetNextSymbolMatch(
  [in]            ULONG64  Handle,
  [out, optional] PSTR     Buffer,
  [in]            ULONG    BufferSize,
  [out, optional] PULONG   MatchSize,
  [out, optional] PULONG64 Offset
);

Parameter

[in] Handle

Menentukan handel yang dikembalikan oleh StartSymbolMatch saat pencarian diinisialisasi.

[out, optional] Buffer

Menerima nama simbol. Jika BufferNULL, simbol yang sama akan dikembalikan lagi lain kali salah satu metode ini dipanggil (dengan handel yang sama); ini dapat digunakan untuk menentukan ukuran nama simbol.

[in] BufferSize

Menentukan ukuran dalam karakter buffer. Ukuran ini mencakup ruang untuk karakter yang mengakhiri '\0'.

[out, optional] MatchSize

Menerima ukuran dalam karakter nama simbol. Ukuran ini mencakup ruang untuk karakter yang mengakhiri '\0'. Jika MatchSizeNULL, informasi ini tidak dikembalikan.

[out, optional] Offset

Menerima lokasi di ruang alamat virtual target dari simbol. Jika OffsetNULL, informasi ini tidak dikembalikan.

Nilai kembali

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

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
S_FALSE	Ukuran buffer terlalu kecil untuk nama simbol, atau Bufferadalah NULL.
E_NOINTERFACE	Tidak ada lagi simbol yang ditemukan yang cocok dengan pola.

Keterangan

Pencarian harus terlebih dahulu diinisialisasi oleh StartSymbolMatch. Setelah semua simbol yang diinginkan ditemukan, EndSymbolMatch dapat digunakan untuk merilis sumber daya yang disimpan mesin untuk pencarian.

Untuk informasi selengkapnya tentang simbol, lihat Simbol.