Udostępnij za pośrednictwem


IDebugReference2

Ten interfejs reprezentuje odwołanie do właściwości ramki stosu lub innej właściwości.

Uwaga

IDebugReference2 jest zarezerwowana do użycia w przyszłości, a wszystkie jej metody powinny zwracać wartość E_NOTIMPL.

Składnia

IDebugReference2 : IUnknown

Uwagi dotyczące implementacji

De implementuje ten interfejs, aby reprezentować odwołanie do określonego rodzaju wartości. Na przykład wartość może być wartością liczbową w wyniku oceny wyrażenia, kontekstu pamięci używanego do wyświetlania pamięci lub listy rejestrów i ich wartości.

Uwagi dotyczące wywoływania

Wywołaj metodę GetReference , aby uzyskać ten interfejs. Polecenia GetParent i GetDerivedMostReference również zwracają ten interfejs.

Metody w tabeli Vtable Order

W poniższej tabeli przedstawiono metody .IDebugReference2

Metoda opis
GetReferenceInfo Pobiera strukturę DEBUG_REFERENCE_INFO, która opisuje to odwołanie.
SetValueAsString Ustawia wartość tego odwołania z ciągu.
SetValueAsReference Ustawia wartość tego odwołania z innego odwołania.
EnumChildren Wylicza elementy podrzędne tego odwołania.
GetParent Pobiera element nadrzędny tego odwołania.
GetDerivedMostReference Pobiera najbardziej pochodne odwołanie do tego odwołania.
GetMemoryBytes Pobiera bajty pamięci, do których odwołuje się to odwołanie.
GetMemoryContext Pobiera kontekst pamięci dla tego odwołania.
GetSize Pobiera rozmiar w bajtach tego odwołania.
SetReferenceType Ustawia ten typ odwołania.
Compare Porównuje to odwołanie z innym.

Uwagi

Uwaga

Użycie "właściwości" nie powinno być mylone z tym, co oznacza zmienną składową klasy, chociaż IDebugReference2 może reprezentować taką jednostkę.

  • IDebugProperty2 reprezentuje właściwość, natomiast IDebugReference2 reprezentuje odwołanie do właściwości, zazwyczaj odwołanie do obiektu w debugowanych programach.

Główną różnicą między właściwością a odwołaniem jest to, że właściwość odwołuje się do nazwanego wystąpienia obiektu, podczas gdy odwołanie odwołuje się do nienazwanego wystąpienia. Na przykład właściwość może odwoływać się do obiektu w stercie programu za pomocą polecenia "a.b". Inna właściwość może odwoływać się do tego samego obiektu co "c.d". Sposób odwoływania się do tej właściwości wymaga, aby "a.b" lub "c.d" był w zakresie. Odwołanie do tego samego obiektu jest bez nazw; obiekt może być określany tak długo, jak pamięć dla tego obiektu jest prawidłowa.

Interfejs IDebugProperty2 można traktować jako wartość o nazwie, typie i adresie. Z IDebugReference2drugiej strony można traktować jako typ i adres.

Wymagania

Nagłówek: msdbg.h

Przestrzeń nazw: Microsoft.VisualStudio.Debugger.Interop

Zestaw: Microsoft.VisualStudio.Debugger.Interop.dll

Zobacz też