ICLRDebugManager::BeginConnection, méthode

Article
08/10/2011

É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.

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 a été retourné avec succès.
HOST_E_CLRNOTAVAILABLE	Le CLR n'a pas été chargé dans un processus ou le CLR présente un état dans lequel il ne peut pas exécuter de code managé ou traiter l'appel avec succès.
HOST_E_TIMEOUT	L'appel a expiré.
HOST_E_NOT_OWNER	L'appelant ne possède pas le verrou.
HOST_E_ABANDONED	Un événement a été annulé alors qu'un thread bloqué ou une fibre l'attendait.
E_FAIL	Une défaillance grave et inconnue s'est produite. Lorsqu'une méthode retourne E_FAIL, le CLR n'est plus utilisable dans le processus. Les appels suivants aux méthodes d'hébergement retournent HOST_E_CLRNOTAVAILABLE.
E_INVALIDARG	dwConnectionId était nul ou BeginConnection avait déjà été appelé à l'aide de cette valeur dwConnectionId ou szConnectionName était null.
E_OUTOFMEMORY	La mémoire allouée est peut-être insuffisante pour permettre de contenir la liste des tâches associée à cette connexion.

Notes

ICLRDebugManager fournit trois méthodes (BeginConnection, SetConnectionTasks et EndConnection) en vue d'associer des listes de tâches à des identificateurs et à des noms conviviaux.

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

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