ICLRErrorReportingManager::BeginCustomDump, méthode

Article
05/10/2023

Spécifie la configuration des vidages de tas personnalisés pour le rapport d’erreurs.

Syntaxe

HRESULT BeginCustomDump (  
    [in] ECustomDumpFlavor dwFlavor,  
    [in] DWORD dwNumItems,  
    [in, size_is(dwNumItems), length_is(dwNumItems)] CustomDumpItem items[],  
    DWORD dwReserved  
);

Paramètres

dwFlavor
[in] Valeur ECustomDumpFlavor indiquant le type de vidage de tas sur lequel construire le vidage de tas personnalisé.

dwNumItems
[in] Longueur du tableau items. Si dwFlavor n’est pas DUMP_FLAVOR_Mini, dwNumItems doit être égal à zéro.

items
[in] Tableau d’instances CustomDumpItem, spécifiant les éléments à ajouter au minidump. Si dwFlavor n’est pas DUMP_FLAVOR_Mini, items doit être null.

dwReserved
[in] Réservé pour une future utilisation.

Valeur de retour

HRESULT	Description
S_OK	Retour réussi de la méthode.
HOST_E_CLRNOTAVAILABLE	Le Common Language Runtime (CLR) n’a pas été chargé dans un processus ou est dans un état dans lequel il ne peut ni exécuter le code managé ni traiter l’appel avec succès.
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. Après qu’une méthode retourne E_FAIL, le CLR n’est plus utilisable dans le processus. Les appels suivants aux méthodes d’hébergement renvoient HOST_E_CLRNOTAVAILABLE.

Notes

La méthode BeginCustomDump définit la configuration de vidage de tas personnalisé. La méthode EndCustomDump efface la configuration de vidage de tas personnalisé et libère tout état associé. Elle devrait être appelée une fois le vidage de tas personnalisé terminé.

Important

L’échec de l’appel de la méthode EndCustomDump provoque une fuite de mémoire.

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

Partager via