Интерфейс ICLRDebugManager

Статья
11/16/2008

Обновлен: Ноябрь 2007

Предоставляет методы, позволяющие узлу связывать набор задач с идентификатором и понятным именем.

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 позволяет узлу реализовать данный вид группирования.

Важное примечание.
Три метода ICLRDebugManager, BeginConnection, SetConnectionTasks и EndConnection зависят друг от друга. Для корректной работы их следует вызывать в приведенном порядке.

Группирование, идентификаторы и понятные имена, назначаемые узлом группированию, не имеют значения для среды 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

См. также

Другие ресурсы

Интерфейсы размещения

Поделиться через