IDebugProperty3
Note
This article applies to Visual Studio 2015. 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
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
Syntax
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 |
|---|---|
| GetStringCharLength | Returns the length of the string associated with the property. |
| GetStringChars | Returns the string in a user-supplied buffer. |
| CreateObjectID | Creates a unique ID for this property. |
| DestroyObjectID | Destroys the unique ID for this property. |
| GetCustomViewerCount | Returns the number of custom viewers that this property can be viewed with. |
| GetCustomViewerList | Returns the list of custom viewers that this property can be viewed with. |
| SetValueAsStringWithError | Sets the value of this property, returning an error message if anything went wrong. |
Remarks
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