BP_RESOLUTION_LOCATION

Article
01/12/2024

Specifies the structure of the breakpoint resolution location.

Syntax

public struct BP_RESOLUTION_LOCATION {
    public uint   bpType;
    public IntPtr unionmember1;
    public IntPtr unionmember2;
    public IntPtr unionmember3;
    public uint   unionmember4;
};

struct _BP_RESOLUTION_LOCATION {
    BP_TYPE bpType;
    union {
        BP_RESOLUTION_CODE bpresCode;
        BP_RESOLUTION_DATA bpresData;
        int                unused;
    } bpResLocation;
} BP_RESOLUTION_LOCATION;

Members

bpType
A value from the BP_TYPE enumeration that specifies how to interpret the bpResLocation union or unionmemberX members.

bpResLocation.bpresCode
[C++ only] Contains the BP_RESOLUTION_CODE structure if bpType = BPT_CODE.

bpResLocation.bpresData
[C++ only] Contains the BP_RESOLUTION_DATA structure if bpType = BPT_DATA.

bpResLocation.unused
[C++ only] A placeholder.

unionmember1
[C# only] See Remarks on how to interpret.

unionmember2
[C# only] See Remarks on how to interpret.

unionmember3
[C# only] See Remarks on how to interpret.

unionmember4
[C# only] See Remarks on how to interpret.

Remarks

This structure is a member of the BP_ERROR_RESOLUTION_INFO and BP_RESOLUTION_INFO structures.

[C# only] The unionmemberX members are interpreted according to the following table. Look down the left column for the bpType value then across to determine what each unionmemberX member represents and marshal the unionmemberX accordingly. See the Example for a way to interpret this structure in C#.

`bpLocationType`	`unionmember1`	`unionmember2`	`unionmember3`	`unionmember4`
`BPT_CODE`	IDebugCodeContext2	-	-	-
`BPT_DATA`	`string` (data expression)	`string` (function name)	`string` (image name)	`enum_BP_RES_DATA_FLAGS`

Example

This example shows how to interpret the BP_RESOLUTION_LOCATION structure in C#.

using System;
using System.Runtime.Interop.Services;
using Microsoft.VisualStudio.Debugger.Interop;

namespace MyPackage
{
    public class MyClass
    {
        public void Interpret(BP_RESOLUTION_LOCATION bprl)
        {
            if (bprl.bpType == (uint)enum_BP_TYPE.BPT_CODE)
            {
                IDebugCodeContext2 pContext = (IDebugCodeContext2)Marshal.GetObjectForIUnknown(bp.unionmember1);
            }
            else if (bprl.bpType == (uint)enum_BP_TYPE.BPT_DATA)
            {
                string dataExpression = Marshal.PtrToStringBSTR(bp.unionmember3);
                string functionName = Marshal.PtrToStringBSTR(bp.unionmember2);
                string imageName = Marshal.PtrToStringBSTR(bp.unionmember3);
                enum_BP_RES_DATA_FLAGS numElements = (enum_BP_RES_DATA_FLAGS)bp.unionmember4;
            }
        }
    }
}

Requirements

Header: msdbg.h

Namespace: Microsoft.VisualStudio.Debugger.Interop

Assembly: Microsoft.VisualStudio.Debugger.Interop.dll

Share via