IHostTaskManager, interface
Mise à jour : novembre 2007
Fournit des méthodes qui permettent au Common Language Runtime (CLR) de travailler avec les tâches par le biais de l'hôte plutôt que d'utiliser les fonctions de threading ou Fiber de système d'exploitation standard.
interface IHostTaskManager : IUnknown
{
HRESULT GetCurrentTask (
[out] IHostTask **pTask
);
HRESULT CreateTask (
[in] DWORD dwStackSize,
[in] LPTHREAD_START_ROUTINE pStartAddress,
[in] PVOID pParameter,
[out] IHostTask **ppTask
);
HRESULT Sleep (
[in] DWORD dwMilliseconds,
[in] DWORD option
);
HRESULT SwitchToTask (
[in] DWORD option
);
HRESULT SetUILocale (
[in] LCID lcid
);
HRESULT SetLocale (
[in] LCID lcid
);
HRESULT CallNeedsHostHook (
[in] SIZE_T target,
[out] BOOL *pbCallNeedsHostHook
);
HRESULT LeaveRuntime (
[in] SIZE_T target
);
HRESULT EnterRuntime ();
HRESULT ReverseLeaveRuntime ();
HRESULT ReverseEnterRuntime ();
HRESULT BeginDelayAbort ();
HRESULT EndDelayAbort ();
HRESULT BeginThreadAffinity ();
HRESULT EndThreadAffinity ();
HRESULT SetStackGuarantee (
[in] ULONG guarantee
);
HRESULT GetStackGuarantee (
[out] ULONG *pGuarantee
);
HRESULT SetCLRTaskManager (
[in] ICLRTaskManager *ppManager
);
}
Méthodes
Méthode |
Description |
---|---|
Avertit l'hôte que le code managé entre dans une période au cours de laquelle la tâche en cours ne doit pas être abandonnée. |
|
Avertit l'hôte que le code managé entre dans une période au cours de laquelle la tâche en cours ne doit pas être déplacée vers un autre thread du système d'exploitation. |
|
Permet à l'hôte de spécifier si le Common Language Runtime (CLR) peut traiter en mode inline l'appel spécifié à une fonction non managée. |
|
Demande que l'hôte crée une tâche. |
|
Avertit l'hôte que le code managé sort de la période dans laquelle la tâche en cours ne doit pas être abandonnée, à la suite d'un appel préalable à BeginDelayAbort. |
|
Avertit l'hôte que le code managé sort de la période dans laquelle la tâche en cours ne doit pas être déplacée vers un autre thread de système d'exploitation, à la suite d'un appel préalable à BeginThreadAffinity. |
|
Avertit l'hôte qu'un appel à une méthode non managée, telle qu'une méthode d'appel de code non managé (PInvoke), retourne le contrôle d'exécution au Common Language Runtime (CLR). |
|
Obtient un pointeur d'interface désignant la tâche en cours d'exécution sur le thread de système d'exploitation à partir duquel l'appel est effectué. |
|
Obtient le montant d'espace de pile qui est disponible de façon garantie après l'achèvement d'une opération de pile, mais avant la fermeture d'un processus. |
|
Avertit l'hôte que le code managé va faire un appel à une fonction non managée. |
|
Avertit l'hôte qu'un appel est en cours dans le Common Language Runtime (CLR) à partir du code non managé. |
|
Avertit l'hôte que le contrôle va passer du CLR à une fonction non managée qui était, à son tour, appelée à partir d'un code managé. |
|
Fournit à l'hôte un pointeur d'interface vers une instance ICLRTaskManager implémentée par le CLR. |
|
Avertit l'hôte que le CLR a modifié les paramètres régionaux sur la tâche en cours. |
|
Réservé exclusivement à un usage interne. |
|
Avertit l'hôte que les paramètres régionaux de l'interface utilisateur ont été modifiés sur la tâche en cours. |
|
Avertit l'hôte que la tâche en cours va se mettre en veille. |
|
Avertit l'hôte qu'il doit éliminer la tâche en cours. |
Notes
IHostTaskManager permet au Common Language Runtime (CLR) de créer et de gérer des tâches, de fournir des connexions à l'hôte pour qu'il agisse lorsque le contrôle est transféré du code managé vers le code non managé et inversement et de spécifier certaines actions que l'hôte peut et ne peut pas effectuer pendant l'exécution du code.
Configuration requise
Plateformes : consultez Configuration requise du .NET Framework.
En-tête : MSCorEE.idl
Bibliothèque : incluse en tant que ressource dans MSCorEE.dll
Versions du .NET Framework : 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0