IHostControl::GetHostManager, méthode

Obtient un pointeur d'interface vers l'implémentation de l'hôte de l'interface avec l'IID spécifié.

HRESULT GetHostManager (
    [in] REFIID riid,
    [out, iid_is(riid)] void** ppObject
);

Paramètres

• riid
  [in] IID de l'interface pour laquelle le Common Language Runtime (CLR) effectue une requête.

• ppObject
  [out] Pointeur vers l'interface implémentée par l'hôte ou null si l'hôte ne prend pas en charge cette interface.

Valeur de retour

HRESULT	Description
S_OK	GetHostManager 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.
E_INVALIDARG	L'IID demandé n'est pas valide.
E_NOINTERFACE	L'interface demandée n'est pas prise en charge.

Notes

Le Common Language Runtime (CLR) interroge l'hôte pour déterminer s'il prend en charge une ou plusieurs des interfaces suivantes :

• IHostMemoryManager

• IHostTaskManager

• IHostThreadPoolManager

• IHostIoCompletionManager

• IHostSyncManager

• IHostAssemblyManager

• IHostGCManager

• IHostPolicyManager

• IHostSecurityManager

Si l'hôte prend en charge l'interface spécifiée, il définit ppObject à son implémentation de cette interface. Sinon, il définit ppObject à null.

Le CLR n'appelle pas Release sur les gestionnaires hôtes, même si vous l'arrêtez.

Configuration requise

Plateformes : consultez Configuration requise du .NET Framework.

En-tête : MSCorEE.h

Bibliothèque : incluse en tant que ressource dans MSCorEE.dll

Versions du .NET Framework : 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Voir aussi

Référence

IHostControl, interface

Historique des modifications

Date	Historique	Motif
Décembre 2010	A clarifié que Release n'est jamais appelé sur les gestionnaires hôte.	Résolution des bogues de contenu.