ICLRTask::SetTaskIdentifier, méthode

Article
08/10/2011

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.

HRESULT SetTaskIdentifier (
    [in] DWORD Asked
);

Paramètres

Asked
[in] Identificateur unique que le Common Language Runtime doit associer à la tâche représentée par l'instance ICLRTask actuelle.

Valeur de retour

HRESULT	Description
S_OK	SetTaskIdentifier a été retourné avec succès.
HOST_E_CLRNOTAVAILABLE	Le 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 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 à une application de débogage. Le débogueur peut utiliser cet identificateur pour associer une pile des appels du CLR à une pile des appels d'hôte et permettre l'unification de leurs informations de traçage respectives lors de l'affichage dans l'interface utilisateur du débogueur.