IDebugCanStopEvent2
Ten interfejs służy do pytania menedżera debugowania sesji (SDM), czy zatrzymać się w bieżącej lokalizacji kodu.
Składnia
IDebugCanStopEvent2 : IUknown
Uwagi dotyczące implementacji
Aparat debugowania (DE) implementuje ten interfejs, aby obsługiwać przechodzenie przez kod źródłowy. Interfejs IDebugEvent2 musi zostać zaimplementowany na tym samym obiekcie co ten interfejs (do uzyskiwania dostępu do interfejsu IDebugEvent2
jest używany program QueryInterface za pomocą narzędzia QueryInterface).
Implementacja tego interfejsu musi komunikować wywołanie modułu SDM canStop do aparatu debugowania. Na przykład można to zrobić za pomocą komunikatu opublikowanego w wątku obsługi komunikatów aparatu debugowania lub obiekt implementowany przez ten interfejs może przechowywać odwołanie do aparatu debugowania i wywoływać z powrotem do aparatu debugowania z flagą przekazaną do IDebugCanStopEvent2::CanStop
elementu .
Uwagi dotyczące wywoływania
De może wysyłać tę metodę za każdym razem, gdy de jest proszony o kontynuowanie wykonywania, a DE przechodzi przez kod. To zdarzenie jest wysyłane przy użyciu funkcji wywołania zwrotnego IDebugEventCallback2 dostarczonej przez SDM po dołączeniu do debugowanego programu.
Metody w tabeli Vtable Order
W poniższej tabeli przedstawiono metody .IDebugCanStopEvent2
Metoda | opis |
---|---|
GetReason | Pobiera przyczynę tego zdarzenia. |
CanStop | Określa, czy debugowany program powinien zatrzymać się w lokalizacji tego zdarzenia (i wysłać zdarzenie, które opisuje przyczynę zatrzymania), czy po prostu kontynuować wykonywanie. |
GetDocumentContext | Pobiera kontekst dokumentu opisujący lokalizację tego zdarzenia. |
GetCodeContext | Pobiera kontekst kodu opisujący lokalizację tego zdarzenia. |
Uwagi
De wysyła ten interfejs, jeśli użytkownik przechodzi do funkcji, a DE nie znajdzie tam informacji debugowania lub informacje debugowania istnieją, ale DE nie wie, czy kod źródłowy może być wyświetlany dla tej lokalizacji.
Wymagania
Nagłówek: msdbg.h
Przestrzeń nazw: Microsoft.VisualStudio.Debugger.Interop
Zestaw: Microsoft.VisualStudio.Debugger.Interop.dll