RegisterForRuntimeStartupEx, funkcja

Wykonuje wywołanie zwrotne, gdy środowisko uruchomieniowe platformy .NET zostanie uruchomione w określonym procesie.

Składnia

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

Parametry

dwProcessId
[in] Identyfikator procesu docelowego.

lpApplicationGroupId
[in] Ciąg reprezentujący identyfikator grupy aplikacji procesu w trybie piaskownicy uruchomiony na komputerze Mac. Przekaż wartość NULL, jeśli proces nie jest uruchomiony w piaskownicy i innych platformach.

pfnCallback
[in] Wywołanie zwrotne wywoływane podczas uruchamiania środowiska uruchomieniowego. Zobacz PSTARTUP_CALLBACK wskaźnik funkcji.

parameter
[in] wskaźnik danych przekazany do pfnCallback.

ppUnregisterToken
[out] wskaźnik, aby zwrócić token UnregisterForRuntimeStartup .

Wartość zwracana

S_OK
Wywołanie zwrotne uruchamiania zostało pomyślnie zarejestrowane.

E_INVALIDARG
Albo pfnCallback albo ppUnregisterToken ma wartość null.

E_FAIL (lub inne E_ kody powrotne)
Rejestracja wywołania zwrotnego nie powiodła się.

Uwagi

Wywołanie zwrotne jest przekazywane prawidłowe wystąpienie ICorDebug dla wersji środowiska uruchomieniowego lub błąd, jeśli coś się nie powiedzie. Ten interfejs API działa na potrzeby uruchamiania i dołączania (a nawet scenariusza dołączania, jeśli środowisko uruchomieniowe nie zostało jeszcze załadowane) w równym stopniu zarówno na platformie xplat, jak i w systemie Windows. Wywołanie zwrotne jest zawsze wywoływane w osobnym wątku. Ten interfejs API zwraca natychmiast. Wywołanie zwrotne jest wywoływane, gdy moduł środowiska uruchomieniowego coreclr jest ładowany podczas wczesnej inicjowania. Środowisko uruchomieniowe jest blokowane podczas inicjowania do momentu powrotu wywołania zwrotnego. Jeśli środowisko uruchomieniowe jest już załadowane w procesie (tak jak w normalnym przypadku dołączania), wywołanie zwrotne jest wykonywane i środowisko uruchomieniowe nie jest blokowane. Wywołanie zwrotne jest zawsze wywoływane w osobnym wątku, a ten interfejs API zwraca natychmiast. Obecnie obsługiwane jest tylko pierwsze wystąpienie modułu coreclr znalezione w procesie docelowym.

Wymagania

Platformy: Zobacz Obsługiwane systemy operacyjne platformy .NET.

Nagłówek: dbgshim.h

Biblioteka: dbgshim.dll, libdbgshim.so, libdbgshim.dylib

Wersje platformy .NET: Dostępne od wersji .NET Core 2.1