Partager via

ICLRErrorReportingManager::BeginCustomDump, méthode

  • Article

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

Voir aussi