Metode IDebugHost::GetCurrentContext (dbgmodel.h)

  • Artikel

Metode GetCurrentContext mengembalikan antarmuka yang mewakili status host debugger saat ini. Arti pasti dari ini diserahkan ke host, tetapi biasanya mencakup hal-hal seperti sesi, proses, dan ruang alamat yang aktif di antarmuka pengguna host debug. Objek konteks yang dikembalikan sebagian besar buram bagi pemanggil tetapi merupakan objek penting untuk diteruskan di antara panggilan ke host debug. Ketika penelepon, misalnya, membaca memori, penting untuk mengetahui proses dan ruang alamat tempat memori dibaca. Gagasan itu dienkapsulasi dalam gagasan objek konteks yang dikembalikan dari metode ini.

Setiap objek dan simbol dalam model data secara opsional memiliki informasi konteks seperti ini yang terkait dengannya. Biasanya juga konteks diteruskan dari satu objek ke objek baru yang dibuat sebagai properti yang ada. Objek seperti itu yang dibuat oleh host debug itu sendiri dapat menyebabkan informasi konteks tambahan disematkan dalam objek yang dikembalikan (misalnya: properti Tumpukan dari utas dapat menyematkan informasi tentang utas mana yang dirujuk oleh tumpukan dalam konteks).

Sintaks

HRESULT GetCurrentContext(
  IDebugHostContext **context
);

Parameter

context

Objek yang mewakili konteks host saat ini dikembalikan di sini.

Mengembalikan nilai

Metode ini mengembalikan HRESULT yang menunjukkan keberhasilan atau kegagalan. Host yang tidak memiliki konsep informasi konteks dapat mengembalikan E_NOTIMPL di sini.

Keterangan

Sampel Kode

ComPtr<IDebugHost> spHost; /* get the debug host */

ComPtr<IDebugHostContext> spContext;
if (SUCCEEDED(spHost->GetCurrentContext(&spContext)))
{
    // spContext now contains an opaque object representing the current UI 
    // state of the debugger (e.g.: what session/process/thread the debug UI 
    // is focused on)
}

Persyaratan

Persyaratan Nilai
Header dbgmodel.h

Lihat juga

Antarmuka IDebugHost