Methode ICLRDebugManager::BeginConnection

Artikel
04/08/2023

Brengt een nieuwe verbinding tot stand tussen de host en het foutopsporingsprogramma om een lijst met taken te koppelen aan een id en een beschrijvende naam.

Syntaxis

HRESULT BeginConnection (  
    [in] CONNID dwConnectionId,  
    [in, string] wchar_t* szConnectionName  
);

Parameters

dwConnectionId
[in] Een id die moet worden gekoppeld aan de lijst met CLR-taken (Common Language Runtime).

szConnectionName
[in] Een beschrijvende naam om te koppelen aan de lijst met CLR-taken.

Retourwaarde

HRESULT	Beschrijving
S_OK	`BeginConnection` is geretourneerd.
HOST_E_CLRNOTAVAILABLE	De CLR is niet geladen in een proces of de CLR heeft 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 slot.
HOST_E_ABANDONED	Een gebeurtenis is geannuleerd terwijl er een geblokkeerde thread of glasvezel 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	`dwConnectionId` was nul, of `BeginConnection` was al aangeroepen met behulp van deze `dwConnectionId` waarde, of `szConnectionName` was null.
E_OUTOFMEMORY	Er kan onvoldoende geheugen worden toegewezen voor de lijst met taken die aan deze verbinding zijn gekoppeld.

Opmerkingen

ICLRDebugManager biedt drie methoden, BeginConnectionSetConnectionTasks en 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