Sdílet prostřednictvím


IDebugSymbolProvider

Toto rozhraní představuje zprostředkovatele symbolů, který poskytuje symboly a typy a vrací je jako pole.

Syntaxe

IDebugSymbolProvider : IUnknown

Poznámky pro implementátory

Zprostředkovatel symbolů musí implementovat toto rozhraní, aby bylo možné zadat informace o symbolu a typu do vyhodnocovače výrazů.

Poznámky pro volající

Toto rozhraní se získá pomocí funkce modelu COM CoCreateInstance (pro nespravované zprostředkovatele symbolů) nebo načtením příslušného sestavení spravovaného kódu a vytvořením instance zprostředkovatele symbolů na základě informací nalezených v tomto sestavení. Ladicí modul vytvoří instanci zprostředkovatele symbolů, aby fungoval v koordinaci s vyhodnocovačem výrazů. Podívejte se na příklad pro jeden přístup k vytvoření instance tohoto rozhraní.

Metody v pořadí Vtable

Následující tabulka ukazuje metody IDebugSymbolProvider.

metoda Popis
Initialize Zastaralé Nepoužívat.
Uninitialize Zastaralé Nepoužívat.
GetContainerField Získá pole, které obsahuje ladicí adresu.
GetField Zastaralé Nepoužívat.
GetAddressesFromPosition Mapy pozici dokumentu do pole ladicích adres.
GetAddressesFromContext Mapy kontext dokumentu do pole ladicích adres.
GetContextFromAddress Mapy ladicí adresu do kontextu dokumentu.
GetLanguage Získá jazyk použitý ke kompilaci kódu na ladicí adrese.
GetGlobalContainer Zastaralé Nepoužívat.
GetMethodFieldsByName Získá pole představující plně kvalifikovaný název metody.
GetClassTypeByName Získá typ pole třídy představující plně kvalifikovaný název třídy.
GetNamespacesUsedAtAddress Vytvoří enumerátor pro obory názvů přidružené k adrese ladění.
GetTypeByName Mapy název symbolu k typu symbolu.
GetNextAddress Získá ladicí adresu, která následuje za danou adresou ladění v metodě.

Poznámky

Toto rozhraní mapuje pozice dokumentů na ladicí adresy a naopak.

Požadavky

Hlavička: sh.h

Obor názvů: Microsoft.VisualStudio.Debugger.Interop

Sestavení: Microsoft.VisualStudio.Debugger.Interop.dll

Příklad

Tento příklad ukazuje, jak vytvořit instanci zprostředkovatele symbolů vzhledem k jeho identifikátoru GUID (ladicí modul musí znát tuto hodnotu).

// 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);
}

Viz také