Dela via


ICLRDebugManager::BeginConnection, metod

Upprättar en ny anslutning mellan värden och felsökaren för att associera en lista över aktiviteter med en identifierare och ett eget namn.

Syntax

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

Parametrar

dwConnectionId
[in] En identifierare som ska associeras med listan över CLR-uppgifter (Common Language Runtime).

szConnectionName
[in] Ett eget namn att associera med listan över CLR-uppgifter.

Returvärde

HRESULT Description
S_OK BeginConnection returnerades.
HOST_E_CLRNOTAVAILABLE CLR har inte lästs in i en process, eller så är CLR i ett tillstånd där den inte kan köra hanterad kod eller bearbeta anropet.
HOST_E_TIMEOUT Tidsgränsen för samtalet överst.
HOST_E_NOT_OWNER Anroparen äger inte låset.
HOST_E_ABANDONED En händelse avbröts medan en blockerad tråd eller fiber väntade på den.
E_FAIL Ett okänt oåterkalleligt fel inträffade. När en metod returnerar E_FAIL kan CLR inte längre användas i processen. Efterföljande anrop till värdmetoder returnerar HOST_E_CLRNOTAVAILABLE.
E_INVALIDARG dwConnectionId var noll, eller BeginConnection anropades redan med det här dwConnectionId värdet eller szConnectionName var null.
E_OUTOFMEMORY Det gick inte att allokera tillräckligt med minne för att lagra listan över aktiviteter som är associerade med den här anslutningen.

Kommentarer

ICLRDebugManager innehåller tre metoder, BeginConnection, SetConnectionTasks och EndConnection, för att associera uppgiftslistor med identifierare och egna namn.

Viktigt

Dessa tre metoder måste anropas i en viss ordning för varje uppsättning aktiviteter. BeginConnection anropas först för att upprätta en ny anslutning. SetConnectionTasks anropas bredvid för att ange den uppsättning uppgifter som ska associeras med den anslutningen. EndConnection anropas sist för att ta bort associationen mellan uppgiftslistan och identifieraren och det egna namnet. Anrop för olika anslutningar kan dock kapslas.

Krav

Plattformar: Se Systemkrav.

Huvudet: MSCorEE.h

Bibliotek: Ingår som en resurs i MSCorEE.dll

.NET Framework versioner: Tillgänglig sedan 2.0

Se även