ICLRTask::SetTaskIdentifier, méthode
Demande au Common Language Runtime (CLR) d’associer la valeur d’identificateur spécifiée à la tâche représentée par l’instance ICLRTask actuelle.
Syntaxe
HRESULT SetTaskIdentifier (
[in] DWORD Asked
);
Paramètres
Asked
[in] Identificateur unique du Common Language Runtime à associer à la tâche représentée par l’instance ICLRTask actuelle.
Valeur de retour
| HRESULT | Description |
|---|---|
| S_OK | SetTaskIdentifier retourné. |
| HOST_E_CLRNOTAVAILABLE | Le CLR n’a pas été chargé dans un processus ou son état ne lui permet pas d’exécuter du code managé ni de traiter l’appel correctement. |
| HOST_E_TIMEOUT | L’appel a expiré. |
| HOST_E_NOT_OWNER | L’appelant n’est pas propriétaire du verrou. |
| HOST_E_ABANDONED | Un événement a été annulé alors qu’un thread ou une fibre bloqué l’attendait. |
| E_FAIL | Une défaillance catastrophique inconnue s’est produite. Quand une méthode retourne E_FAIL, le CLR n’est plus utilisable au sein du processus. Les appels suivants aux méthodes d’hébergement renvoient HOST_E_CLRNOTAVAILABLE. |
Notes
L’hôte peut associer un identificateur à une tâche pour faciliter l’intégration du CLR et de l’hôte dans un environnement de débogage. L’identificateur n’a aucune signification pour le CLR. Le CLR le passe à un débogueur. Le débogueur peut utiliser cet identificateur pour associer une pile d’appels CLR à une pile d’appels hôte et permettre l’unification de leurs informations de trace respectives pour consultation dans l’interface utilisateur du débogueur.
Spécifications
Plateformes : Consultez Configuration requise.
En-tête : MSCorEE.h
Bibliothèque : incluse en tant que ressource dans MsCorEE.dll
Versions de .NET Framework : Disponible depuis la version 2.0
