IActionOnCLREvent::OnEvent — Metoda
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
