IDebugSettingsCallback2

Applies to: yesVisual Studio noVisual Studio for Mac

Note

This article applies to Visual Studio 2017. If you're looking for the latest Visual Studio documentation, see Visual Studio documentation. We recommend upgrading to the latest version of Visual Studio. Download it here

Enables debug engines to read metric settings remotely.

Syntax

IDebugSettingsCallback2 : IUnknown

Notes for Implementers

This interface is implemented by the event callback of the session debug manager and consumed by debug engines. It could also be used locally instead of Dbgmetric[d].lib.

Methods

The following table shows the methods of IDebugSettingsCallback2.

Method Description
EnumEEs Enumerates the available expression evaluators given the language and vendor identifiers.
GetEELocalObject Retrieves a expression evaluator local object given the metric.
GetEEMetricDword Retrieves a value that corresponds to the specified metric of the expression evaluator.
GetEEMetricFile Retrieves the expression evaluator metric file given the name or the metric.
GetEEMetricGuid Retrieves the unique identifier for a expression evaluator metric given its name.
GetEEMetricString Retrieves the value string of an expression evaluator metric given its name.
GetMetricDword Retrieves the value of a metric given its name.
GetMetricGuid Retrieves the unique identifier of a metric given its name.
GetMetricString Retrieves the value string of the metric given its name.

Requirements

Header: Msdbg.h

Namespace: Microsoft.VisualStudio.Debugger.Interop

Assembly: Microsoft.VisualStudio.Debugger.Interop.dll

Example

The following example shows a function that takes an IDebugSettingsCallback2 object as a parameter.

HRESULT GetDebugSettingsCallback (IDebugSettingsCallback2 **ppCallback)
{
    HRESULT hRes = E_FAIL;

    if ( ppCallback )
    {
        if ( EVAL(m_pdec) )
            hRes = m_pdec->QueryInterface(IID_IDebugSettingsCallback2, (void **)ppCallback);
        else
            hRes = E_FAIL;
    }
    else
        hRes = E_INVALIDARG;

    return ( hRes );
}