ICLRDebugManager::BeginConnection — Metoda
Ustanawia nowe połączenie między hostem a debugerem w celu skojarzenia listy zadań z identyfikatorem i przyjazną nazwą.
Składnia
HRESULT BeginConnection (
[in] CONNID dwConnectionId,
[in, string] wchar_t* szConnectionName
);
Parametry
dwConnectionId
[in] Identyfikator do skojarzenia z listą zadań środowiska uruchomieniowego języka wspólnego (CLR).
szConnectionName
[in] Przyjazna nazwa do skojarzenia z listą zadań CLR.
Wartość zwracana
| HRESULT | Opis |
|---|---|
| S_OK | BeginConnection zwrócone pomyślnie. |
| HOST_E_CLRNOTAVAILABLE | ClR nie został załadowany do procesu lub CLR jest w stanie, w którym nie może uruchomić zarządzanego kodu lub przetworzyć wywołania pomyślnie. |
| HOST_E_TIMEOUT | Upłynął limit czasu wywołania. |
| HOST_E_NOT_OWNER | Obiekt wywołujący nie jest właścicielem blokady. |
| HOST_E_ABANDONED | Zdarzenie zostało anulowane, gdy zablokowany wątek lub światłowod czekał na nie. |
| E_FAIL | Wystąpił nieznany katastrofalny błąd. Gdy metoda zwróci E_FAIL, clR nie będzie już można jej używać w ramach tego procesu. Kolejne wywołania metod hostingu zwracają HOST_E_CLRNOTAVAILABLE. |
| E_INVALIDARG | dwConnectionId był zerowy lub BeginConnection był już wywoływany przy użyciu tej dwConnectionId wartości lub szConnectionName miał wartość null. |
| E_OUTOFMEMORY | Nie można przydzielić wystarczającej ilości pamięci do przechowywania listy zadań skojarzonych z tym połączeniem. |
Uwagi
ICLRDebugManager udostępnia trzy metody, BeginConnection, SetConnectionTasks i EndConnection, do kojarzenia list zadań z identyfikatorami i przyjaznymi nazwami.
Ważne
Te trzy metody muszą być wywoływane w określonej kolejności dla każdego zestawu zadań. BeginConnection element jest wywoływany jako pierwszy w celu nawiązania nowego połączenia. SetConnectionTasks element jest wywoływany obok, aby zapewnić zestaw zadań, które mają być skojarzone z tym połączeniem. EndConnection Element jest wywoływany jako ostatni, aby usunąć skojarzenie między listą zadań a identyfikatorem i przyjazną nazwą. Jednak wywołania dla różnych połączeń mogą być zagnieżdżone.
Wymagania
Platformy: Zobacz Wymagania systemowe.
Nagłówka: MSCorEE.h
Biblioteki: Uwzględnione jako zasób w MSCorEE.dll
wersje .NET Framework: dostępne od wersji 2.0
