Fonction RegisterForRuntimeStartup

Exécute le rappel lorsque le runtime .NET démarre dans le processus spécifié.

Syntaxe

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

Paramètres

dwProcessId
[in] ID de processus du processus cible.

pfnCallback
[in] Rappel appelé au démarrage du runtime. Consultez PSTARTUP_CALLBACK pointeur de fonction.

parameter
[in] pointeur de données passé à pfnCallback.

ppUnregisterToken
[out] pointeur pour renvoyer le jeton UnregisterForRuntimeStartup .

Valeur retournée

S_OK
Le rappel de démarrage a été correctement inscrit.

E_INVALIDARG
La pfnCallback valeur null ou ppUnregisterToken la valeur est null.

E_FAIL (ou d’autres E_ codes de retour)
Échec de l’inscription de rappel.

Remarques

Le rappel est passé l’instance ICorDebug appropriée pour la version du runtime ou une erreur en cas d’échec. Cette API fonctionne pour le lancement et l’attachement (et même le scénario d’attachement si le runtime n’a pas encore été chargé) de manière égale sur xplat et Windows. Le rappel est toujours appelé sur un thread distinct. Cette API retourne immédiatement. Le rappel est appelé lorsque le module d’exécution coreclr est chargé lors de l’initialisation anticipée. Le runtime est bloqué pendant l’initialisation jusqu’à ce que le rappel retourne. Si le runtime est déjà chargé dans le processus (comme dans le cas normal de l’attachement), le rappel est exécuté et le runtime n’est pas bloqué. Le rappel est toujours appelé sur un thread distinct et cette API retourne immédiatement. Seule la première instance de module coreclr trouvée dans le processus cible est actuellement prise en charge.

Spécifications

Plates-formes: Consultez les systèmes d’exploitation pris en charge par .NET.

En-tête : dbgshim.h

Bibliothèque : dbgshim.dll, libdbgshim.so, libdbgshim.dylib

Versions de .NET : Disponible depuis .NET Core 2.1