ICLRDebugManager

Actualización: noviembre 2007

Proporciona métodos que permiten a un host asociar un conjunto de tareas a un identificador y un nombre descriptivo.

interface ICLRDebugManager: IUnknown {
    HRESULT BeginConnection (
        [in] CONNID dwConnectionId, 
        [in, string] wchar_t * szConnectionName
    );
    HRESULT EndConnection (
        [in] CONNID dwConnectionId
    );
    HRESULT GetDacl (
        [out] PACL* ppacl
    );
    HRESULT IsDebuggerAttached (
        [out] BOOL *pbAttached
    );
    HRESULT SetConnectionTasks (
        [in] CONNID id,
        [in] DWORD dwCount,
        [in, size_is(dwCount)] ICLRTask **ppCLRTask
    );
    HRESULT SetDacl (
        [in] PACL pacl
    );
    HRESULT SetSymbolReadingPolicy (
        [in] ESymbolReadingPolicy policy
    );
};

Métodos

Método	Descripción
ICLRDebugManager::BeginConnection (Método)	Establece una nueva conexión entre el host y el depurador para asociar un identificador y un nombre descriptivo a tareas.
ICLRDebugManager::EndConnection (Método)	Quita la asociación entre una lista de tareas y un identificador y un nombre descriptivo.
ICLRDebugManager::GetDacl (Método)	Este método no está implementado.
ICLRDebugManager::IsDebuggerAttached (Método)	Obtiene un valor que indica si hay un depurador asociado al proceso.
ICLRDebugManager::SetConnectionTasks (Método)	Asocia una lista de instancias de ICLRTask a un identificador y un nombre descriptivo.
ICLRDebugManager::SetDacl (Método)	Este método no está implementado.
ICLRDebugManager::SetSymbolReadingPolicy (Método)	Establece la directiva para leer archivos de base de datos de programa (PDB). La directiva determina si la información sobre números de línea y archivos se incluye en las pilas de llamadas.

Comentarios

En escenarios de depuración, un host podría desear agrupar las tareas según su propia lógica de programación. Por ejemplo, una agrupación permitiría a un programador ver solamente las tareas requeridas por las API del programador, en lugar de ver todas las tareas que se ejecutan en el proceso. ICLRDebugManager permite al host implementar este tipo de agrupación.

Nota importante:
Tres métodos de ICLRDebugManager, BeginConnection, SetConnectionTasks y EndConnection, son interdependientes. Se deben llamar en el orden especificado para que funcionen de la forma esperada.

La agrupación y los identificadores y nombres descriptivos que el host asigna a la agrupación no tienen ningún significado para Common Language Runtime (CLR). CLR solamente pasa la información al depurador.

Requisitos

Plataformas: vea Requisitos de sistema de .NET Framework.

Encabezado: MSCorEE.idl

Biblioteca: se incluye como recurso en MSCorEE.dll

Versiones de .NET Framework: 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Vea también

Otros recursos

Interfaces de hospedaje