ICLRDebugManager::SetConnectionTasks — Metoda
Kojarzy listę wystąpień ICLRTask z identyfikatorem i przyjazną nazwą.
Składnia
HRESULT SetConnectionTasks (
[in] CONNID id,
[in] DWORD dwCount,
[in, size_is(dwCount)] ICLRTask **ppCLRTask
);
Parametry
id
[w] Identyfikator specyficzny dla hosta dla połączenia, z którym ma być skojarzana tablica ppCLRTask
.
dwCount
[w] Liczba członków .ppCLRTask
Ta liczba musi być większa niż zero.
ppCLRTask
[w] Tablica ICLRTask
wskaźników do skojarzenia z połączeniem zidentyfikowanym przez id
usługę . Ta tablica musi zawierać co najmniej jeden element członkowski.
Wartość zwracana
HRESULT | Opis |
---|---|
S_OK | SetConnectionTasks zwrócono pomyślnie. |
HOST_E_CLRNOTAVAILABLE | Środowisko uruchomieniowe języka wspólnego (CLR) nie zostało załadowane do procesu lub CLR jest w stanie, w którym nie może uruchomić kodu zarządzanego ani pomyślnie przetworzyć wywołania. |
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 używać w ramach tego procesu. Kolejne wywołania metod hostingu zwracają HOST_E_CLRNOTAVAILABLE. |
E_INVALIDARG | Funkcja BeginConnection nie została wywołana przy użyciu tej wartości id lub dwCount id jest równa zero, albo jeden z elementów elementu ppCLRTask ma wartość null. |
Uwagi
ICLRDebugManager udostępnia trzy metody, BeginConnection
, SetConnectionTasks
i EndConnection, do kojarzenia list zadań z identyfikatorami i przyjazne nazwy.
Ważne
Te trzy metody muszą być wywoływane w określonej kolejności dla każdego zestawu zadań. BeginConnection
jest wywoływana jako pierwsza 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
jest wywoływana ostatnio, aby usunąć skojarzenie między listą zadań a identyfikatorem i przyjazną nazwą. Można jednak zagnieżdżać wywołania dla różnych połączeń.
Wymagania
Platformy: Zobacz Wymagania systemowe.
Nagłówka: MSCorEE.h
Biblioteki: Uwzględnione jako zasób w MSCorEE.dll
.NET Framework wersje: dostępne od wersji 2.0