IHostControl::GetHostManager, méthode

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

Syntaxe

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

Paramètres

riid
[in] IID de l’interface que le Common Language Runtime (CLR) interroge.

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 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.
E_INVALIDARG	Le IID demandé n’est pas valide.
E_NOINTERFACE	L’interface demandée n’est pas prise en charge.

Notes

Le 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 sur son implémentation de cette interface. Sinon, il définit ppObject sur la valeur Null.

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

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

Voir aussi

• IHostControl, interface