ICLRDebugManager

2008-08-18

更新：2007 年 11 月

提供允许宿主将一组任务与某个标识符及友好名称关联起来的方法。

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
    );
};

方法

方法	说明
ICLRDebugManager::BeginConnection 方法	在宿主与调试器之间建立新连接，以便将任务与标识符和友好名称关联起来。
ICLRDebugManager::EndConnection 方法	移除任务列表与标识符和友好名称之间的关联。
ICLRDebugManager::GetDacl 方法	此方法未实现。
ICLRDebugManager::IsDebuggerAttached 方法	获取一个值，它指示调试器是否已附加到进程。
ICLRDebugManager::SetConnectionTasks 方法	将 ICLRTask 实例列表与标识符及友好名称关联。
ICLRDebugManager::SetDacl 方法	此方法未实现。
ICLRDebugManager::SetSymbolReadingPolicy 方法	设置用于读取程序数据库 (PDB) 文件的策略。该策略决定是否在调用堆栈中包含有关行号和文件的信息。

备注

在调试方案中，宿主可能需要依据它自己的编程逻辑对任务进行分组。例如，分组将仅允许开发人员看到该开发人员的 API 所需的任务，而不让其看到正在进程中运行的每项任务。ICLRDebugManager 允许宿主实现这种分组。

重要说明：
BeginConnection、SetConnectionTasks 和 EndConnection 这三个 ICLRDebugManager 方法互相依赖。必须按照给定顺序对它们进行调用以达到预期效果。

分组以及宿主分配给分组的标识符和友好名称对于公共语言运行库 (CLR) 而言没有任何意义。CLR 只是将这些信息传递给调试器。

要求

**平台：**请参见 .NET Framework 系统要求。

**头文件：**MSCorEE.idl

**库：**作为一项资源包含在 MSCorEE.dll 中

**.NET Framework 版本：**3.5 SP1、3.5、3.0 SP1、3.0、2.0 SP1、2.0

请参见

其他资源

宿主接口

通过

ICLRDebugManager

方法

备注

要求

请参见

其他资源

其他资源