當 .NET 運行時間在指定的進程中啟動時,執行回呼。
語法
HRESULT RegisterForRuntimeStartupEx (
[in] DWORD dwProcessId,
[in] LPCWSTR lpApplicationGroupId,
[in] PSTARTUP_CALLBACK pfnCallback,
[in] PVOID parameter,
[out] PVOID *ppUnregisterToken)
);
參數
dwProcessId
[in]目標進程的進程標識碼。
lpApplicationGroupId
[in]字串,表示在 Mac 中執行的沙箱化進程的應用程式群組識別碼。 如果進程未在沙箱和其他平台中執行,請傳遞NULL。
pfnCallback
[in]運行時間啟動時叫用的回呼。 請參閱 函式指標PSTARTUP_CALLBACK 。
parameter
[in] 傳遞至 pfnCallback的數據指標。
ppUnregisterToken
[out] 指標,可傳回 UnregisterForRuntimeStartup 令牌。
返回值
S_OK
已成功註冊啟動回呼。
E_INVALIDARG
pfnCallback或 ppUnregisterToken 為 null。
E_FAIL (或其他 E_ 傳回碼)
回呼註冊失敗。
備註
回呼會針對運行時間版本傳遞適當的 ICorDebug 實例,如果發生錯誤,則傳回。 此 API 適用於啟動和附加(即使尚未載入運行時間的附加案例),同樣適用於 xplat 和 Windows。 回呼一律會在個別線程上呼叫。 此 API 會立即傳回。 在早期初始化期間載入 coreclr 執行時間模組時,會叫用回呼。 在初始化期間會封鎖運行時間,直到回呼傳回為止。 如果運行時間已在進程中載入(如同一般附加案例),則會執行回呼,且不會封鎖運行時間。 回呼一律會在個別線程上叫用,而且此 API 會立即傳回。 目前僅支援在目標進程中找到的第一個coreclr模組實例。
需求
平臺: 請參閱 .NET 支援的作系統。
標頭: dbgshim.h
連結庫: dbgshim.dll、libdbgshim.so、libdbgshim.dylib
.NET 版本: 自 .NET Core 2.1 起提供