Metode IDebugDataSpaces4::SearchVirtual2 (dbgeng.h)

  • Artikel

Metode SearchVirtual2 mencari memori virtual proses untuk pola byte tertentu.

Sintaks

HRESULT SearchVirtual2(
  [in]  ULONG64  Offset,
  [in]  ULONG64  Length,
  [in]  ULONG    Flags,
  [in]  PVOID    Pattern,
  [in]  ULONG    PatternSize,
  [in]  ULONG    PatternGranularity,
  [out] PULONG64 MatchOffset
);

Parameter

[in] Offset

Menentukan lokasi di ruang alamat virtual proses untuk mulai mencari pola.

[in] Length

Menentukan seberapa jauh untuk mencari pola. Kecocokan yang berhasil mengharuskan seluruh pola ditemukan sebelum Byte panjang telah diperiksa.

[in] Flags

Menentukan bidang bit bendera untuk pencarian. Saat ini, satu-satunya bendera bit yang dapat diatur adalah DEBUG_VSEARCH_WRITABLE_ONLY, yang membatasi pencarian ke memori bisa-tulis.

[in] Pattern

Menentukan pola yang akan dicari.

[in] PatternSize

Menentukan ukuran, dalam byte, dari pola. Ini harus menjadi kelipatan granularitas pola.

[in] PatternGranularity

Menentukan granularitas pola. Untuk kecocokan yang berhasil, perbedaan antara lokasi pola yang ditemukan dan Offset harus merupakan kelipatan PatternGranularity.

[out] MatchOffset

Menerima lokasi di ruang alamat virtual proses pola, jika ditemukan.

Nilai kembali

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

Menampilkan kode Deskripsi
S_OK
 Metode berhasil.
HRESULT_FROM_NT(STATUS_NO_MORE_ENTRIES)
 Setelah memeriksa Panjang byte, pola tidak ditemukan.

Keterangan

Metode ini mencari memori virtual target untuk kejadian pertama, tunduk pada granularitas, dari pola yang sepenuhnya terkandung dalam Byte panjang memori target, dimulai dari lokasi Offset .

PatternGranularity dapat digunakan untuk memastikan keselarasan kecocokan relatif terhadap Offset. Misalnya, nilai 0x4 dapat digunakan untuk memerlukan penyelarasan ke DWORD. Nilai 0x1 dapat digunakan untuk memungkinkan pola dimulai dari mana saja.

Persyaratan

Persyaratan Nilai
Target Platform Desktop
Header dbgeng.h (termasuk Dbgeng.h)

Lihat juga

IDebugDataSpaces4

SearchVirtual