IDebugHostContext-Schnittstelle (dbgmodel.h)

Stellt einen Kontext dar, in dem der Debugger Fragen beantwortet (welche Sitzung, welcher Prozess, welcher Thread).

Vererbung

IDebugHostContext erbt von IUnknown.

Methoden

Die IDebugHostContext-Schnittstelle verfügt über diese Methoden.

IDebugHostContext::AddRef Die IDebugHostContext::AddRef-Methode erhöht die Verweisanzahl für eine Schnittstelle für ein Objekt.
IDebugHostContext::IsEqualTo Gibt zurück, ob zwei IDebugHostContext-Objekte wertgleich sind.
IDebugHostContext::QueryInterface Die IDebugHostContext::QueryInterface-Methode ruft Zeiger auf die unterstützten Schnittstellen für ein Objekt ab.
IDebugHostContext::Release Die IDebugHostContext::Release-Methode erhöht die Verweisanzahl für eine Schnittstelle für ein Objekt.

Hinweise

Kontextobjekte sind undurchsichtige Informationsblobs, die der Debughost (in Zusammenarbeit mit dem Datenmodell) mit jedem Objekt verknüpft. Es kann Dinge wie den Prozesskontext oder den Adressraum enthalten, aus dem die Informationen stammen, usw... Ein Kontextobjekt ist eine Implementierung von IDebugHostContext, die in einem IModelObject enthalten ist.

Beachten Sie, dass IDebugHostContext eine vom Host definierte Schnittstelle ist. Ein Client implementiert diese Schnittstelle nie.

Kontext: Der Adressraum

Es ist wichtig zu beachten, dass Datenmodellschnittstellen diesen Kontext im Gegensatz zu früheren Erweiterungsmodellen, bei denen der Kontext (das Ziel, der Prozess, der Thread, den Sie betrachten) ein Ui-Konzept mit allen APIs relativ zum aktuellen UI-Zustand ist, diesen Kontext in der Regel explizit oder implizit als IDebugHostContext-Schnittstelle verwenden. Jedes IModelObject innerhalb des Datenmodells trägt diese Art von Kontextinformationen mit und kann diesen Kontext an zurückgegebene Objekte weitergeben. Dies bedeutet, dass beim Lesen eines nativen Werts oder eines Schlüsselwerts aus einem IModelObject das Ziel und der Prozess, von dem das Objekt ursprünglich abgerufen wurde, ausgelesen wird. Es gibt einen expliziten konstanten Wert, USE_CURRENT_HOST_CONTEXT, der an Methoden übergeben werden kann, die ein IDebugHostContext-Argument verwenden. Dieser Wert gibt an, dass der Kontext tatsächlich der aktuelle Ui-Zustand des Debuggers sein sollte. Dieser Begriff muss jedoch explizit sein.

Anforderungen

Anforderung	Wert
Header	dbgmodel.h

Weitere Informationen

Debuggerdatenmodell C++-Übersicht