ICLRDebugManager::SetConnectionTasks-metod

Artikel
05/10/2023

Associerar en lista över ICLRTask-instanser med en identifierare och ett eget namn.

Syntax

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

Parametrar

id
[i] Den värdspecifika identifieraren för anslutningen som matrisen ska associeras ppCLRTask med.

dwCount
[i] Antalet medlemmar i ppCLRTask. Det här talet måste vara större än noll.

ppCLRTask
[i] En matris ICLRTask med pekare som ska associeras med anslutningen som identifieras av id. Den här matrisen måste innehålla minst en medlem.

Returvärde

HRESULT	Description
S_OK	`SetConnectionTasks` returnerades korrekt.
HOST_E_CLRNOTAVAILABLE	CLR (Common Language Runtime) 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	Samtalets tidsgräns ö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	BeginConnection har inte anropats med det här värdet `id`, eller `dwCount` är `id` noll eller ett av elementen `ppCLRTask` i är null.

Kommentarer

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

Viktigt

Dessa tre metoder måste anropas i en specifik ordning för varje uppsättning uppgifter. BeginConnection anropas först för att upprätta en ny anslutning. SetConnectionTasks anropas bredvid för att ange den uppsättning aktiviteter som ska associeras med 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

Dela via