IDebugProperty3

  • Article

This interface provides support for:

  • Retrieving an arbitrarily long string associated with the property.

  • Associating a unique ID with the property.

  • Retrieving a list of custom viewers for the property.

  • Setting the value of a property with the ability to report any resulting errors

IDebugProperty3 : IDebugProperty2

Notes for Implementers

The debug engine (DE) implements this interface on the same object that implements IDebugProperty2 to provide support for long strings, property IDs, and custom viewers.

Notes for Callers

Call QueryInterface on an IDebugProperty2 interface to obtain this interface.

Methods in Vtable Order

In addition to the methods inherited from IDebugProperty2, the IDebugProperty3 interface exposes the following methods.

Method

Description

IDebugProperty3::GetStringCharLength

Returns the length of the string associated with the property.

IDebugProperty3::GetStringChars

Returns the string in a user-supplied buffer.

IDebugProperty3::CreateObjectID

Creates a unique ID for this property.

IDebugProperty3::DestroyObjectID

Destroys the unique ID for this property.

IDebugProperty3::GetCustomViewerCount

Returns the number of custom viewers that this property can be viewed with.

IDebugProperty3::GetCustomViewerList

Returns the list of custom viewers that this property can be viewed with.

IDebugProperty3::SetValueAsStringWithError

Sets the value of this property, returning an error message if anything went wrong.

Remarks

IDebugProperty3::SetValueAsStringWithError is the preferred way for the session debug manager (SDM) to set a property's value.

Requirements

Header: msdbg.h

Namespace: Microsoft.VisualStudio.Debugger.Interop

Assembly: Microsoft.VisualStudio.Debugger.Interop.dll

See Also

Reference

IDebugProperty2

IDebugCustomViewer

Concepts

Core Interfaces