ICLRDebugManager

Article
08/22/2008

Mise à jour : novembre 2007

Fournit des méthodes qui permettent à un hôte d'associer un jeu de tâches à un identificateur et un nom convivial.

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éthodes

Méthode	Description
ICLRDebugManager::BeginConnection, méthode	Établit une nouvelle connexion entre l'hôte et le débogueur pour associer les tâches à un identificateur et à un nom convivial.
ICLRDebugManager::EndConnection, méthode	Supprime l'association entre une liste de tâches et un identificateur et un nom convivial.
ICLRDebugManager::GetDacl, méthode	Cette méthode n'est pas implémentée.
ICLRDebugManager::IsDebuggerAttached, méthode	Obtient une valeur qui indique si un débogueur est attaché au processus.
ICLRDebugManager::SetConnectionTasks, méthode	Associe une liste d'instances ICLRTask à un identificateur et à un nom convivial.
ICLRDebugManager::SetDacl, méthode	Cette méthode n'est pas implémentée.
ICLRDebugManager::SetSymbolReadingPolicy, méthode	Définit la stratégie de lecture des fichiers de base de données du programme (PDB). La stratégie détermine si des informations sur les numéros de ligne et les fichiers sont incluses dans les piles des appels.

Notes

Dans certains scénarios de débogage, un hôte peut regrouper des tâches en fonction de sa propre programmation logique. Par exemple, un regroupement peut permettre à un développeur de consulter uniquement les tâches requises par ses propres API, au lieu de consulter chaque tâche qui s'exécute dans le processus. ICLRDebugManager permet à l'hôte d'implémenter ce type de regroupement.

Remarque importante :
Trois méthodes ICLRDebugManager, BeginConnection, SetConnectionTasks et EndConnection sont dépendantes les unes des autres. Elles doivent être appelées dans l'ordre indiqué pour qu'elles puissent fonctionner comme prévu.

Le regroupement, ainsi que les identificateurs et les noms conviviaux que l'hôte assigne au regroupement, n'ont aucune signification pour le Common Language Runtime (CLR). Le CLR se contente de passer les informations au débogueur.

Configuration requise

Plateformes : consultez Configuration requise du .NET Framework.

En-tête : MSCorEE.idl

Bibliothèque : incluse en tant que ressource dans MSCorEE.dll

Versions du .NET Framework : 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Voir aussi

Autres ressources

Interfaces d'hébergement

Partager via