Método IDebugHost::GetCurrentContext (dbgmodel.h)
El método GetCurrentContext devuelve una interfaz que representa el estado actual del host del depurador. El significado exacto de esto se deja en el host, pero normalmente incluye cosas como la sesión, el proceso y el espacio de direcciones que está activo en la interfaz de usuario del host de depuración. El objeto de contexto devuelto es en gran medida opaco para el autor de la llamada, pero es un objeto importante para pasar entre llamadas al host de depuración. Cuando un autor de la llamada es, por ejemplo, leer memoria, es importante saber desde qué proceso y espacio de direcciones se lee la memoria. Esa noción se encapsula en la noción del objeto de contexto que se devuelve de este método.
Opcionalmente, todos los objetos y símbolos del modelo de datos tienen información de contexto como esta asociada. También suele ser habitual que el contexto se pase de un objeto a nuevos objetos creados como propiedades de los existentes. Estos objetos creados por el propio host de depuración pueden hacer que la información de contexto adicional se inserte en el objeto devuelto (por ejemplo, la propiedad Stack de un subproceso puede insertar información sobre el subproceso al que hace referencia la pila dentro del contexto).
Sintaxis
HRESULT GetCurrentContext(
IDebugHostContext **context
);
Parámetros
context
Aquí se devuelve un objeto que representa el contexto actual del host.
Valor devuelto
Este método devuelve HRESULT, que indica que se ha realizado correctamente o no. Un host que no tiene un concepto de información de contexto puede devolver E_NOTIMPL aquí.
Observaciones
de ejemplo de código de
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)
}
Requisitos
| Requisito | Valor |
|---|---|
| encabezado de | dbgmodel.h |