ICLRDebugManager::SetConnectionTasks, méthode

Article
05/10/2023

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

Partager via