DkmUserMessage 类

  • 参考

定义

命名空间:
Microsoft.VisualStudio.Debugger
程序集:
Microsoft.VisualStudio.Debugger.Engine.dll

包含要向用户显示的消息的相关信息。

public ref class DkmUserMessage
[Windows::Foundation::Metadata::WebHostHidden]
public ref class DkmUserMessage
[Windows::Foundation::Metadata::WebHostHidden]
class DkmUserMessage
[System.Runtime.InteropServices.Guid("1a166c7c-4ae6-0992-82e2-c75555ed8055")]
public class DkmUserMessage
[<System.Runtime.InteropServices.Guid("1a166c7c-4ae6-0992-82e2-c75555ed8055")>]
type DkmUserMessage = class
Public Class DkmUserMessage
继承
Object
DkmUserMessage
属性
GuidAttribute

属性

Connection

用于将消息发送到调试器的连接。 此值通常是从 DkmProcess 获取的，除非在创建 DkmProcess 之前需要发送消息。
ErrorCode

要为其显示消息的错误代码。 如果消息不是错误的，则应将此值 S_OK (0) 。
MessageBoxFlags

来自 winuser.h 的 Win32 消息框标志 (例如： MB_OK) 。 如果 OutputKind 未设置为 "MessageBox"，则将忽略这些标志。
MessageText

要在消息框中或在 "输出" 窗口中显示的文本。 如果提供错误代码，则 "%1" 将被替换为错误消息的文本。 例如： ' 无法在头上建立备用。 %1 "。
OutputKind

指示应在调试器 IDE 中输出 DkmUserMessage 的位置。
Process

可有可无此消息引用的进程。
TimeStamp

可选的时间戳值。 通常，在创建对象时通过 QueryPerformanceCounter 获得。 请注意，如果在远程处理层的本地端创建了对象，则不会有时间戳。

此 API 是在 Visual Studio 14 RTM (VS14RTM) 中引入的。

方法

Create(DkmTransportConnection, DkmProcess, DkmUserMessageOutputKind, String, MessageBoxFlags, Int32)

创建新的 DkmUserMessage 对象实例。
Create(DkmTransportConnection, DkmProcess, DkmUserMessageOutputKind, String, MessageBoxFlags, Int32, UInt64)

创建新的 DkmUserMessage 对象实例。

         此 API 是在 Visual Studio 14 RTM (VS14RTM) 中引入的。
DisplayPrompt()

在 Visual Studio 调试器 IDE 中向用户显示一条消息。 此函数等待 Visual Studio IDE 处理此消息。 不能从作为 UI 事件处理的一部分运行的代码调用此方法。 这样做会导致死锁。 此方法要求 DkmUserMessage 为非 null。
DisplayPrompt(DkmWorkList, DkmCompletionRoutine<DkmDisplayUserMessagePromptAsyncResult>)

在 Visual Studio 调试器 IDE 中向用户显示一条消息。 此方法是异步实现。 执行完成后，将调用 DkmProcess，并将用户响应 (是/否) 。 此方法要求 DkmUserMessage 为非 null。

此方法会将新工作项追加到指定的工作列表，并在追加工作项后返回。 工作项的实际处理是异步的。 向调用方发送请求完成后，将收到通过完成例程的通知。

此 API 是在 Visual Studio 12 RTM (VS12RTM) 中引入的。
Post()

在 Visual Studio 调试器 IDE 中向用户显示一条消息。 此函数不会阻止用户关闭错误消息。

适用于