GetStartupNotificationEvent 関数

指定された対象プロセスに読み込まれている任意の共通言語ランタイム (CLR: Common Language Runtime) によって通知されるイベント ハンドルを作成または開きます。 この 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 がプロセス識別子に対応づけられます。

イベントは、通知元の CLR によってマネージド コードが実行される前に通知されます。

必要条件

プラットフォーム:.NET supported operating systems をご参照ください。

ヘッダー: dbgshim.h

ライブラリ: dbgshim.dll

.NET のバージョン: .NET Core 2.1 以降で使用可能