Partager via

ICLRDebugManager::SetConnectionTasks, méthode

  • Article

Associe une liste d’instances ICLRTask à un identificateur et un nom convivial.

Syntaxe

HRESULT SetConnectionTasks (  
    [in] CONNID id,  
    [in] DWORD dwCount,  
    [in, size_is(dwCount)] ICLRTask **ppCLRTask  
);

Paramètres

id
[in] Identificateur propre à l’hôte pour la connexion à laquelle associer le tableau ppCLRTask.

dwCount
[in] Nombre de membres de ppCLRTask. Ce nombre doit être supérieur à zéro.

ppCLRTask
[in] Tableau de pointeurs ICLRTask à associer à la connexion identifiée par id. Ce tableau doit contenir au moins un membre.

Valeur de retour

HRESULT Description
S_OK SetConnectionTasks retourné.
HOST_E_CLRNOTAVAILABLE Le Common Language Runtime (CLR) n’a pas été chargé dans un processus ou est dans un état dans lequel il ne peut ni exécuter le code managé ni traiter l’appel avec succès.
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 BeginConnection n’a pas été appelé en utilisant cette valeur de id, ou dwCount ou id est égal à zéro, ou l’un des éléments de ppCLRTask est null.

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

Voir aussi