Funzione RegisterForRuntimeStartup

Esegue il callback all'avvio del runtime .NET nel processo specificato.

Sintassi

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

Parametri

dwProcessId
[in] ID del processo di destinazione.

pfnCallback
[in] Callback richiamato all'avvio del runtime. Vedere PSTARTUP_CALLBACK puntatore a funzione.

parameter
[in] puntatore dati passato a pfnCallback.

ppUnregisterToken
[out] puntatore per restituire il token UnregisterForRuntimeStartup .

Valore restituito

S_OK
Il callback di avvio è stato registrato correttamente.

E_INVALIDARG
pfnCallback O ppUnregisterToken è null.

E_FAIL (o altri E_ codici restituiti)
La registrazione del callback non è riuscita.

Osservazioni:

Il callback viene passato all'istanza ICorDebug appropriata per la versione del runtime o a un errore in caso di errore. Questa API funziona per l'avvio e il collegamento (e anche lo scenario di collegamento se il runtime non è stato ancora caricato) in modo uniforme su xplat e Windows. Il callback viene sempre chiamato su un thread separato. Questa API restituisce immediatamente. Il callback viene richiamato quando il modulo di runtime coreclr viene caricato durante l'inizializzazione anticipata. Il runtime viene bloccato durante l'inizializzazione fino a quando il callback non viene restituito. Se il runtime è già caricato nel processo (come nel normale caso di collegamento), il callback viene eseguito e il runtime non viene bloccato. Il callback viene sempre richiamato su un thread separato e questa API restituisce immediatamente. Attualmente è supportata solo la prima istanza del modulo coreclr trovata nel processo di destinazione.

Requisiti

Piattaforme: Vedere Sistemi operativi supportati da .NET.

Intestazione: dbgshim.h

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

Versioni di .NET: Disponibile a partire da .NET Core 2.1