Metode IDebugSymbols3::GetOffsetByNameWide (dbgeng.h)

Metode GetOffsetByNameWide mengembalikan lokasi simbol yang diidentifikasi berdasarkan nama.

Sintaks

HRESULT GetOffsetByNameWide(
  [in]  PCWSTR   Symbol,
  [out] PULONG64 Offset
);

Parameter

[in] Symbol

Menentukan nama simbol yang akan ditemukan. Nama mungkin memenuhi syarat dengan nama modul (misalnya, mymodule!main).

[out] Offset

Menerima lokasi di ruang alamat memori target dari dasar alokasi memori simbol.

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	Metode berhasil. Namun, nama Simbol tidak unik dan beberapa simbol dengan nama itu ditemukan. Salah satu simbol ini dipilih dan dikembalikan secara acak.
E_FAIL	Tidak ada simbol yang dapat ditemukan dengan nama yang ditentukan.

Keterangan

Jika nama Simbol tidak unik dan GetOffsetByName menemukan beberapa simbol dengan nama tersebut, maka ambiguitas akan diselesaikan secara segan-segan. Dalam hal ini nilai S_FALSE akan dikembalikan. StartSymbolMatch dapat digunakan untuk memulai pencarian untuk menentukan mana yang merupakan hasil yang diinginkan.

GetNameByOffset tidak mendukung pencocokan pola (misalnya kartubebas). Untuk menemukan simbol menggunakan pencocokan pola, gunakan StartSymbolMatch.

Jika nama modul untuk simbol diketahui, yang terbaik adalah memenuhi syarat nama simbol dengan nama modul. Jika tidak, mesin akan mencari simbol untuk semua modul sampai menemukan kecocokan; ini dapat memakan waktu lama jika harus memuat file simbol untuk banyak modul. Jika nama simbol memenuhi syarat dengan nama modul, mesin hanya mencari simbol untuk modul tersebut.

Untuk informasi selengkapnya tentang simbol dan nama simbol, lihat Simbol.

Persyaratan

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

Lihat juga

GetNameByOffset

IDebugSymbols3