Interface ICLRDebugManager

Artigo
08/25/2010

Fornece métodos que permitem que um host associar um conjunto de tarefas com um identificador e um nome amigável.

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	Descrição
Método ICLRDebugManager::BeginConnection	Estabelece uma conexão entre o host e o depurador para associar um identificador e um nome amigável tarefas Nova.
Método ICLRDebugManager::EndConnection	Remove a associação entre uma lista de tarefas e um identificador e um nome amigável.
Método ICLRDebugManager::GetDacl	Este método não implementado.
Método ICLRDebugManager::IsDebuggerAttached	Obtém um valor que indica se um depurador é anexado ao processo.
Método ICLRDebugManager::SetConnectionTasks	Associa uma lista de ICLRTask instâncias com um identificador e um nome amigável.
Método ICLRDebugManager::SetDacl	Este método não implementado.
Método ICLRDebugManager::SetSymbolReadingPolicy	Define a diretiva de leitura de arquivos de programa do banco de dados (PDB). A diretiva determina se as informações sobre números de linha e os arquivos estão incluídas no pilhas de chamadas.

Comentários

Em cenários de depuração, um host pode querer agrupar de tarefas de acordo com sua própria lógica de programação. Por exemplo, um agrupamento permitiria que um desenvolvedor ver apenas as tarefas exigidas por APIs do desenvolvedor, em vez de ver todas as tarefas em execução no processo. ICLRDebugManager permite que o host implementar esse tipo de agrupamento.

Observação importante:
Três ICLRDebugManager métodos, BeginConnection, SetConnectionTasks e EndConnection, dependem uns dos outros. Eles devem ser chamados na ordem determinada funcione conforme o esperado.

O agrupamento, identificadores e nomes amigáveis que atribui o host ao agrupamento não têm significado para o common linguagem tempo de execução (CLR). O CLR simplesmente passa as informações junto ao depurador.

Requisitos

Plataformas: See Requisitos de sistema do .NET framework.

Cabeçalho: MSCorEE.idl

Biblioteca: Incluído sistema autônomo um recurso em MSCorEE.dll

.NET Framework Versions: 3.5 SP1, 3,5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Consulte também

Outros recursos

Interfaces de hospedagem

Partilhar via