Функция RegisterForRuntimeStartup

Выполняет обратный вызов при запуске среды выполнения .NET в указанном процессе.

Синтаксис

HRESULT RegisterForRuntimeStartup (
    [in] DWORD dwProcessId,
    [in] PSTARTUP_CALLBACK pfnCallback,
    [in] PVOID parameter,
    [out] PVOID *ppUnregisterToken)
);

Параметры

dwProcessId
[in] Идентификатор процесса целевого процесса.

pfnCallback
[in] Обратный вызов, который вызывается при запуске среды выполнения. См. указатель функции PSTARTUP_CALLBACK .

parameter
Указатель данных [in], переданный в pfnCallback.

ppUnregisterToken
Указатель на возврат маркера 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