Methode ICLRDebugManager::SetConnectionTasks

Artikel
04/08/2023

Koppelt een lijst met ICLRTask-exemplaren aan een id en een beschrijvende naam.

Syntaxis

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

Parameters

id
[in] De hostspecifieke id voor de verbinding waaraan de ppCLRTask matrix moet worden gekoppeld.

dwCount
[in] Het aantal leden van ppCLRTask. Dit getal moet groter zijn dan nul.

ppCLRTask
[in] Een matrix met ICLRTask aanwijzers die moeten worden gekoppeld aan de verbinding die wordt geïdentificeerd door id. Deze matrix moet ten minste één lid bevatten.

Retourwaarde

HRESULT	Beschrijving
S_OK	`SetConnectionTasks` is geretourneerd.
HOST_E_CLRNOTAVAILABLE	De Common Language Runtime (CLR) is niet geladen in een proces of de CLR bevindt zich in een status waarin beheerde code niet kan worden uitgevoerd of de aanroep kan worden verwerkt.
HOST_E_TIMEOUT	Er is een time-out opgetreden voor het gesprek.
HOST_E_NOT_OWNER	De beller is niet de eigenaar van het vergrendelingsslot.
HOST_E_ABANDONED	Een gebeurtenis is geannuleerd terwijl er een geblokkeerde thread of vezel op wachtte.
E_FAIL	Er is een onbekende catastrofale fout opgetreden. Nadat een methode E_FAIL retourneert, is de CLR niet meer bruikbaar binnen het proces. Volgende aanroepen naar hostingmethoden retourneren HOST_E_CLRNOTAVAILABLE.
E_INVALIDARG	BeginConnection is niet aangeroepen met behulp van deze waarde van `id`, of `dwCountid` is nul, of een van de elementen van `ppCLRTask` is null.

Opmerkingen

ICLRDebugManager biedt drie methoden, BeginConnection, SetConnectionTasksen EndConnection, voor het koppelen van takenlijsten aan id's en beschrijvende namen.

Belangrijk

Deze drie methoden moeten voor elke set taken in een specifieke volgorde worden aangeroepen. BeginConnection wordt als eerste aangeroepen om een nieuwe verbinding tot stand te brengen. SetConnectionTasks wordt aangeroepen naast om de set taken op te geven die aan die verbinding moeten worden gekoppeld. EndConnection wordt als laatste aangeroepen om de koppeling tussen de takenlijst en de id en beschrijvende naam te verwijderen. Aanroepen voor verschillende verbindingen kunnen echter worden genest.

Vereisten

Platforms: Zie Systeemvereisten.

Header: MSCorEE.h

Bibliotheek: Opgenomen als een resource in MSCorEE.dll

.NET Framework versies: beschikbaar sinds 2.0

Delen via