ICLRDebugManager::BeginConnection, méthode

Article
05/10/2023

Établit une nouvelle connexion entre l’hôte et le débogueur pour associer une liste de tâches à un identificateur et un nom convivial.

Syntaxe

HRESULT BeginConnection (  
    [in] CONNID dwConnectionId,  
    [in, string] wchar_t* szConnectionName  
);

Paramètres

dwConnectionId
[in] Identificateur à associer à la liste des tâches du Common Language Runtime (CLR).

szConnectionName
[in] Nom convivial à associer à la liste des tâches du CLR.

Valeur de retour

HRESULT	Description
S_OK	`BeginConnection` retourné.
HOST_E_CLRNOTAVAILABLE	Le CLR n’a pas été chargé dans un processus ou son état ne lui permet pas d’exécuter du code managé ni de traiter l’appel correctement.
HOST_E_TIMEOUT	L’appel a expiré.
HOST_E_NOT_OWNER	L’appelant n’est pas propriétaire du verrou.
HOST_E_ABANDONED	Un événement a été annulé alors qu’un thread ou une fibre bloqué l’attendait.
E_FAIL	Une défaillance catastrophique inconnue s’est produite. Après qu’une méthode retourne E_FAIL, le CLR n’est plus utilisable dans le processus. Les appels suivants aux méthodes d’hébergement renvoient HOST_E_CLRNOTAVAILABLE.
E_INVALIDARG	`dwConnectionId` est égal à zéro, `BeginConnection` a déjà été appelé en utilisant cette valeur `dwConnectionId` ou `szConnectionName` est null.
E_OUTOFMEMORY	La mémoire allouée pour contenir la liste des tâches associées à cette connexion est peut-être insuffisante.

Notes

ICLRDebugManager fournit trois méthodes pour associer des listes de tâches à des identificateurs et des noms conviviaux : BeginConnection, SetConnectionTasks et EndConnection.

Important

Ces trois méthodes doivent être appelées dans un ordre spécifique pour chaque ensemble de tâches. La méthode BeginConnection est appelée en premier pour établir une nouvelle connexion. La méthode SetConnectionTasks est ensuite appelée pour fournir l’ensemble de tâches à associer à cette connexion. La méthode EndConnection est appelée en dernier pour supprimer l’association entre la liste des tâches et l’identificateur et le nom convivial. Toutefois, les appels pour différentes connexions peuvent être imbriqués.

Spécifications

Plateformes : Consultez Configuration requise.

En-tête : MSCorEE.h

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

Versions de .NET Framework : Disponible depuis la version 2.0

Partager via