Udostępnij za pośrednictwem

IActionOnCLREvent::OnEvent — Metoda

  • Artykuł

Wykonuje wywołania zwrotne zdarzeń zarejestrowanych przy użyciu wywołania metody ICLROnEventManager::RegisterActionOnEvent .

Składnia

HRESULT OnEvent (  
    [in] EClrEvent event,  
    [in] PVOID     data  
);

Parametry

event
[w] Jedna z wartości EClrEvent , która wskazuje typ zdarzenia.

data
[w] Wskaźnik do obiektu zawierającego szczegółowe informacje o eventobiekcie .

Wartość zwracana

HRESULT Opis
S_OK OnEvent 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. Jeśli metoda zwróci E_FAIL, clR nie będzie już można używać w ramach tego procesu. Kolejne wywołania metody hostingu zwracają HOST_E_CLRNOTAVAILABLE.

Uwagi

Parametr data jest wskaźnikiem do obiektu nieokreślonego typu. event Jeśli parametr to Event_DomainUnload, data jest identyfikatorem liczbowym, który AppDomain został zwolniony. Host może podjąć odpowiednie działania przy użyciu tego identyfikatora jako klucza.

Jeśli event jest Event_MDAFiredto , data jest wskaźnikiem do wystąpienia MDAInfo , które zawiera komunikaty wyjściowe z zarządzanego asystenta debugowania (MDA). MdAs to funkcja clR, która pomaga deweloperom w debugowaniu, generując komunikaty XML dotyczące zdarzeń, które w przeciwnym razie są trudne do pułapki. Takie komunikaty mogą być szczególnie przydatne podczas debugowania przejść między zarządzanym i niezarządzanych kodami. Aby uzyskać więcej informacji, zobacz Diagnozowanie błędów za pomocą asystentów zarządzanego debugowania.

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ż