GetStartupNotificationEvent 函数

创建或打开一个事件句柄,由在指定目标进程中加载的公共语言运行时 (CLR) 对其发出信号。 此 API 仅限 Windows。

语法

HRESULT GetStartupNotificationEvent (
    [in]  DWORD     debuggeePID,
    [out]  HANDLE*  phStartupEvent
);

参数

debuggeePID
[in] 从其中接收 CLR 启动通知的目标进程的进程标识符。

phStartupEvent
[out] 指向在启动时由 CLR 发出信号通知的句柄的指针。

返回值

S_OK
成功获取启动通知事件的句柄。

E_INVALIDARG
phStartupEvent 为 null 或 debuggeePID 不引用当前正在运行的进程。

E_FAIL(或其他 E_ 返回代码)
无法获取启动通知事件的句柄。

备注

在 Windows 操作系统上,debuggeePID 映射到 OS 进程标识符。

在发出信号通知事件的 CLR 执行任何托管代码之前,对该事件发出了信号。

要求

平台:请参阅 .NET 支持的操作系统

标头:dbgshim.h

库:dbgshim.dll

.NET 版本:自 .NET Core 2.1 起可用