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 起可用