Udostępnij przez

IDebugSymbolProvider

Ten interfejs reprezentuje dostawcę symboli, który udostępnia symbole i typy, zwracając je jako pola.

Składnia

IDebugSymbolProvider : IUnknown

Uwagi dotyczące implementacji

Dostawca symboli musi zaimplementować ten interfejs, aby dostarczyć symbol i informacje o typie do ewaluatora wyrażeń.

Uwagi dotyczące wywoływania

Ten interfejs jest uzyskiwany przy użyciu funkcji modelu COM CoCreateInstance (dla dostawców symboli niezarządzanych) lub przez załadowanie odpowiedniego zestawu kodu zarządzanego i utworzenie wystąpienia dostawcy symboli na podstawie informacji znalezionych w tym zestawie. Aparat debugowania tworzy wystąpienie dostawcy symboli w celu współpracy z ewaluatorem wyrażeń. Zobacz Przykładowe podejście do tworzenia wystąpienia tego interfejsu.

Metody w tabeli Vtable Order

W poniższej tabeli przedstawiono metody .IDebugSymbolProvider

Metoda opis
Initialize Przestarzałe. Nie używaj.
Uninitialize Przestarzałe. Nie używaj.
GetContainerField Pobiera pole zawierające adres debugowania.
GetField Przestarzałe. Nie używaj.
GetAddressesFromPosition Mapy położenie dokumentu w tablicę adresów debugowania.
GetAddressesFromContext Mapy kontekstu dokumentu do tablicy adresów debugowania.
GetContextFromAddress Mapy adres debugowania w kontekście dokumentu.
GetLanguage Pobiera język używany do kompilowania kodu pod adresem debugowania.
GetGlobalContainer Przestarzałe. Nie używaj.
GetMethodFieldsByName Pobiera pole reprezentujące w pełni kwalifikowaną nazwę metody.
GetClassTypeByName Pobiera typ pola klasy reprezentujący w pełni kwalifikowaną nazwę klasy.
GetNamespacesUsedAtAddress Tworzy moduł wyliczający dla przestrzeni nazw skojarzonych z adresem debugowania.
GetTypeByName Mapy nazwę symbolu do typu symbolu.
GetNextAddress Pobiera adres debugowania, który jest zgodny z danym adresem debugowania w metodzie.

Uwagi

Ten interfejs mapuje pozycje dokumentów na adresy debugowania i odwrotnie.

Wymagania

Nagłówek: sh.h

Przestrzeń nazw: Microsoft.VisualStudio.Debugger.Interop

Zestaw: Microsoft.VisualStudio.Debugger.Interop.dll

Przykład

W tym przykładzie pokazano, jak utworzyć wystąpienie dostawcy symboli, biorąc pod uwagę jego identyfikator GUID (aparat debugowania musi znać tę wartość).

// A debug engine uses its own symbol provider and would know the GUID
// of that provider.
IDebugSymbolProvider *GetSymbolProvider(GUID *pSymbolProviderGuid)
{
    // This is typically defined globally. For this example, it is
    // defined here.
    static const WCHAR strRegistrationRoot[] = L"Software\\Microsoft\\VisualStudio\\8.0Exp";
    IDebugSymbolProvider *pProvider = NULL;
    if (pSymbolProviderGuid != NULL) {
        CLSID clsidProvider = { 0 };
        ::GetSPMetric(*pSymbolProviderGuid,
                      storetypeFile,
                      metricCLSID,
                      &clsidProvider,
                      strRegistrationRoot);
        if (IsEqualGUID(clsidProvider,GUID_NULL)) {
            // No file type provider, try metadata provider.
            ::GetSPMetric(*pSymbolProviderGuid,
                          ::storetypeMetadata,
                          metricCLSID,
                          &clsidProvider,
                          strRegistrationRoot);
        }
        if (!IsEqualGUID(clsidProvider,GUID_NULL)) {
            CComPtr<IDebugSymbolProvider> spSymbolProvider;
            spSymbolProvider.CoCreateInstance(clsidProvider);
            if (spSymbolProvider != NULL) {
                pProvider = spSymbolProvider.Detach();
            }
        }
    }
    return(pProvider);
}

Zobacz też

  • Last updated on