IDebugProperty3

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