ICLRErrorReportingManager::BeginCustomDump, méthode

Article
08/10/2011

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

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 qui indique le genre de dump de tas sur lequel générer le dump du tas personnalisé.
dwNumItems
[in] Longueur du tableau items. Si dwFlavor n'est pas DUMP_FLAVOR_Mini, dwNumItems doivent avoir une valeur zéro.
items
[in] Tableau d'instances de CustomDumpItem, spécifiant les éléments à ajouter au minidump. Si dwFlavor n'est pas DUMP_FLAVOR_Mini, items doivent avoir une valeur 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 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.

Notes

La méthode BeginCustomDump définit la configuration du dump du tas personnalisé. La méthode EndCustomDump efface la configuration du dump du tas personnalisé et libère tout état qui y est associé. Il doit être appelé après la fin du dump du tas personnalisé.