Share via

Fonction WerReportAddDump (werapi.h)

  • Article

Ajoute un vidage du type spécifié au rapport de Rapport d'erreurs Windows (WER) spécifié.

Syntaxe

HRESULT WerReportAddDump(
  [in]           HREPORT                    hReportHandle,
  [in]           HANDLE                     hProcess,
  [in, optional] HANDLE                     hThread,
  [in]           WER_DUMP_TYPE              dumpType,
  [in, optional] PWER_EXCEPTION_INFORMATION pExceptionParam,
  [in, optional] PWER_DUMP_CUSTOM_OPTIONS   pDumpCustomOptions,
  [in]           DWORD                      dwFlags
);

Paramètres

[in] hReportHandle

Handle du rapport. Ce handle est retourné par la fonction WerReportCreate .

[in] hProcess

Handle du processus pour lequel le rapport est généré. Ce handle doit disposer des droits d’accès STANDARD_RIGHTS_READ et PROCESS_QUERY_INFORMATION.

[in, optional] hThread

Handle du thread de hProcess pour lequel le rapport est généré. Si dumpType est WerDumpTypeMicro, ce paramètre est obligatoire. Pour d’autres types de vidage, ce paramètre peut être NULL.

[in] dumpType

Type de minidump. Ce paramètre peut être l’une des valeurs suivantes du type d’énumération WER_DUMP_TYPE .

Valeur Signification
WerDumpTypeHeapDump
 Minidump étendu qui contient des données supplémentaires telles que la mémoire de processus.

Ce type équivaut à créer un minidump avec les options suivantes :

  • MiniDumpWithDataSegs
  • MiniDumpWithProcessThreadData
  • MiniDumpWithHandleData
  • MiniDumpWithPrivateReadWriteMemory
  • MiniDumpWithUnloadedModules
  • MiniDumpWithFullMemoryInfo
  • MiniDumpWithThreadInfo (Windows 7 et versions ultérieures)
  • MiniDumpWithTokenInformation (Windows 7 et versions ultérieures)
  • MiniDumpWithPrivateWriteCopyMemory (Windows 7 et versions ultérieures)
WerDumpTypeMicroDump
 Minidump limité qui contient uniquement une trace de pile.

Ce type équivaut à créer un minidump avec les options suivantes :

  • MiniDumpWithDataSegs
  • MiniDumpWithUnloadedModules
  • MiniDumpWithProcessThreadData
  • MiniDumpWithoutOptionalData
WerDumpTypeMiniDump
 Un minidump.

Ce type équivaut à créer un minidump avec les options suivantes :

  • MiniDumpWithDataSegs
  • MiniDumpWithUnloadedModules
  • MiniDumpWithProcessThreadData
  • MiniDumpWithTokenInformation (Windows 7 et versions ultérieures)

[in, optional] pExceptionParam

Pointeur vers une structure WER_EXCEPTION_INFORMATION qui spécifie les informations d’exception.

[in, optional] pDumpCustomOptions

Pointeur vers une structure WER_DUMP_CUSTOM_OPTIONS qui spécifie des options de minidump personnalisées. Si ce paramètre a la valeur NULL, les informations de minidump standard sont collectées.

[in] dwFlags

Ce paramètre peut être 0 ou la valeur suivante.

Valeur Signification
WER_DUMP_NOHEAP_ONQUEUE
 Si le rapport est mis en file d’attente, n’incluez pas de vidage du tas. L’utilisation de cet indicateur permet d’économiser de l’espace disque.

Valeur retournée

Cette fonction retourne S_OK en cas de réussite ou un code d’erreur en cas d’échec.

Remarques

Utilisez cette fonction uniquement pour la création de rapports génériques. Elle n’a aucun effet sur les incidents du système d’exploitation ou les rapports de non-réponse.

Si le serveur demande un mini dump et que vous spécifiez WerDumpTypeHeapDump pour le paramètre dumpType , WER n’envoie pas le vidage du tas au serveur Watson. Toutefois, si le serveur demande un vidage du tas et que le dumpType est WerDumpTypeMiniDump, WER envoie le mini dump au serveur. Par conséquent, il est recommandé de définir dumpType sur WerDumpTypeMiniDump.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête werapi.h
Bibliothèque Wer.lib
DLL Wer.dll

Voir aussi

Minidump Files, WER_DUMP_CUSTOM_OPTIONS, WER_EXCEPTION_INFORMATION, WerReportCreate, Rapport d'erreurs Windows