Udostępnij za pośrednictwem


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 idusł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 idlub dwCountid jest równa zero, albo jeden z elementów elementu ppCLRTask ma wartość null.

Uwagi

ICLRDebugManager udostępnia trzy metody, BeginConnection, SetConnectionTasksi 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

Zobacz też