ICLRDebugManager::SetConnectionTasks, méthode

Article
08/10/2011

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

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

Paramètres

id
[in] Identificateur spécifique à l'hôte pour la connexion auquel 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 a été retourné avec succès.
HOST_E_CLRNOTAVAILABLE	Le Common Language Runtime (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	Soit BeginConnection n'a pas été appelé à l'aide de cette valeur id, soit dwCount ou id est nul, soit l'un des éléments de ppCLRTask est null.

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.