ICLRDebugManager

Aggiornamento: novembre 2007

Fornisce metodi che consentono a un host di associare un insieme di attività a un identificatore e a un nome descrittivo.

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

Metodi

Metodo	Descrizione
Metodo ICLRDebugManager::BeginConnection	Stabilisce una nuova connessione tra l'host e il debugger per associare le attività a un identificatore e a un nome descrittivo.
Metodo ICLRDebugManager::EndConnection	Rimuove l'associazione tra un elenco di attività e un identificatore e un nome descrittivo.
Metodo ICLRDebugManager::GetDacl	Questo metodo non è implementato.
Metodo ICLRDebugManager::IsDebuggerAttached	Ottiene un valore che indica se un debugger è connesso al processo.
Metodo ICLRDebugManager::SetConnectionTasks	Associa un elenco di istanze di ICLRTask a un identificatore e un nome descrittivo.
Metodo ICLRDebugManager::SetDacl	Questo metodo non è implementato.
Metodo ICLRDebugManager::SetSymbolReadingPolicy	Imposta il criterio per la lettura dei file del database di programma (PDB). Il criterio determina se le informazioni sui numeri di riga e i file sono incluse negli stack di chiamate.

Note

Negli scenari di debug, un host potrebbe volere raggruppare le attività secondo la propria logica di programmazione. Ad esempio, un raggruppamento consentirebbe a un sviluppatore di visualizzare solo le attività richieste dalle API dello sviluppatore, anziché visualizzare tutte le attività in esecuzione nel processo. ICLRDebugManager consente all’host di implementare questo tipo di raggruppamento.

Nota importante:
Tre metodi ICLRDebugManager, BeginConnection, SetConnectionTasks e EndConnection, dipendono uno dall'altro. Per funzionare correttamente devono quindi essere chiamati nell'ordine stabilito.

Il raggruppamento e gli identificatori e i nomi descrittivi che l'host assegna al raggruppamento non hanno alcun significato per Common Language Runtime (CLR). CLR si limita a passare tali informazioni al debugger.

Requisiti

Piattaforme: vedere Requisiti di sistema di .NET Framework.

Intestazione: MSCorEE.idl

Libreria: inclusa come risorsa in MSCorEE.dll

Versioni di .NET Framework: 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Vedere anche

Altre risorse

Interfacce di hosting