ICorDebugHeapValue3::GetMonitorEventWaitList, méthode

  • Article

Fournit la liste triée des threads mis en file d’attente sur l’événement associé à un verrou d’analyse.

Syntaxe

HRESULT GetMonitorEventWaitList (  
    [out] ICorDebugThreadEnum **ppThreadEnum  
);

Paramètres

ppThreadEnum
[out] Énumérateur ICorDebugThreadEnum qui fournit la liste triée des threads.

Valeur de retour

Cette méthode retourne les HRESULT spécifiques suivants ainsi que les erreurs HRESULT indiquant l'échec de la méthode.

HRESULT Description
S_OK The list is not empty.
S_FALSE La liste est vide.

Exceptions

Remarques

Le premier thread de la liste correspond au premier thread publié par l’appel suivant à Monitor.Pulse(Object). Le thread suivant de la liste est publié lors de l’appel suivant, et ainsi de suite.

Si la liste n’est pas vide, cette méthode renvoie S_OK. Si la liste est vide, la méthode renvoie S_FALSE ; dans ce cas, l’énumération est toujours valide, bien qu’elle soit vide.

Dans les deux cas, l’interface d’énumération est uniquement utilisable pour la durée de l’état synchronisé actuel. Toutefois, les interfaces distribuées par le thread sont valides jusqu’à ce que celui-ci se termine.

Si ppThreadEnum n’est pas un pointeur valide, le résultat n’est pas défini.

Si une erreur se produit et qu’il est impossible de déterminer quels threads, le cas échéant, attendent l’analyse, la méthode renvoie un HRESULT qui indique un échec.

Spécifications

Plateformes : Consultez Configuration requise.

En-tête : CorDebug.idl, CorDebug.h

Bibliothèque : CorGuids.lib

Versions de .NET Framework : Disponible depuis la version 4

Voir aussi