Megosztás:


ICLRDebugManager::BeginConnection metódus

Új kapcsolatot hoz létre a gazdagép és a hibakereső között a feladatok listájának azonosítóval és felhasználóbarát névvel való társításához.

Szintaxis

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

Paraméterek

dwConnectionId
[in] A közös nyelvi futtatókörnyezeti (CLR-) feladatok listájához társítandó azonosító.

szConnectionName
[in] A CLR-feladatok listájához társítandó rövid név.

Visszatérési érték

HRESULT Description
S_OK BeginConnection sikeresen visszaadott.
HOST_E_CLRNOTAVAILABLE A CLR nincs betöltve egy folyamatba, vagy a CLR olyan állapotban van, amelyben nem tudja futtatni a felügyelt kódot, vagy nem tudja sikeresen feldolgozni a hívást.
HOST_E_TIMEOUT A hívás túllépte az időkorlátot.
HOST_E_NOT_OWNER A hívó nem rendelkezik a zárral.
HOST_E_ABANDONED Egy esemény megszakadt, miközben egy blokkolt szál vagy szál várt rá.
E_FAIL Ismeretlen katasztrofális hiba történt. Miután egy metódus visszaadta E_FAIL, a CLR már nem használható a folyamaton belül. Az üzemeltetési módszerek későbbi hívásai HOST_E_CLRNOTAVAILABLE ad vissza.
E_INVALIDARG dwConnectionId nulla volt, vagy BeginConnection már meghívták ezzel az dwConnectionId értékkel, vagy szConnectionName null értékű volt.
E_OUTOFMEMORY Nem sikerült elegendő memóriát lefoglalni a kapcsolathoz társított feladatok listájának tárolásához.

Megjegyzések

Az ICLRDebugManager három, a SetConnectionTasks és az EndConnection metódust BeginConnectionbiztosít a feladatlisták azonosítókkal és felhasználóbarát névvel való társítására.

Fontos

Ezt a három metódust külön sorrendben kell meghívni az egyes tevékenységekhez. BeginConnection az új kapcsolat létrehozásához először meghívja a rendszer. SetConnectionTasks A a következőt hívja meg, hogy megadja a kapcsolathoz társítandó tevékenységek készletét. EndConnection A a feladatlista és az azonosító és a rövid név közötti társítás eltávolításához a last (utolsó) nevet adja. A különböző kapcsolatok hívásai azonban egymásba ágyazhatók.

Követelmények

Platformok: Lásd: Rendszerkövetelmények.

Fejléc: MSCorEE.h

Könyvtár: Erőforrásként szerepel a MSCorEE.dll

.NET-keretrendszer verziók: 2.0 óta elérhető

Lásd még