ICLROnEventManager::RegisterActionOnEvent, méthode

Article
08/10/2011

Enregistre un pointeur de rappel pour l'événement spécifié.

HRESULT RegisterActionOnEvent (
    [in] EClrEvent event,
    [in] IActionOnCLREvent *pAction
);

Paramètres

event
[in] Une des valeurs EClrEvent indiquant l'événement pour lequel enregistrer le pointeur de rappel décrit par pAction.
pAction
[in] Pointeur vers un objet IActionOnCLREvent qui est appelé lorsque l'événement enregistré se déclenche.

Valeur de retour

HRESULT	Description
S_OK	RegisterActionOnEvent a été retourné avec succès.
HOST_E_CLRNOTAVAILABLE	Le Common Language Runtime (CLR) n'a pas été chargé dans un processus ou le CLR présente un état dans lequel il ne peut pas exécuter de code managé ou traiter l'appel avec succès.
HOST_E_TIMEOUT	L'appel a expiré.
HOST_E_NOT_OWNER	L'appelant ne possède pas le verrou.
HOST_E_ABANDONED	Un événement a été annulé alors qu'un thread bloqué ou une fibre l'attendait.
E_FAIL	Une défaillance grave et inconnue s'est produite. Lorsqu'une méthode retourne E_FAIL, le CLR n'est plus utilisable dans le processus. Les appels suivants aux méthodes d'hébergement retournent HOST_E_CLRNOTAVAILABLE.

Notes

L'hôte peut enregistrer des rappels pour l'un ou l'autre ou pour des deux types d'événements décrits par EClrEvent. L'hôte obtient l'interface ICLROnEventManager en appelant la méthode ICLRControl::GetCLRManager.

Remarque
Les événements enregistrés par RegisterActionOnEvent peuvent être déclenchés à plusieurs reprises et à partir de threads différents, de manière à signaler un déchargement ou la désactivation du CLR.