IDebugClient4 ::WriteDumpFileWide, méthode (dbgeng.h)

Article
02/06/2025

La méthode WriteDumpFileWide crée un fichier de vidage en mode utilisateur ou en mode noyaucrash.

Syntaxe

HRESULT WriteDumpFileWide(
  [in, optional] PCWSTR  FileName,
  [in]           ULONG64 FileHandle,
  [in]           ULONG   Qualifier,
  [in]           ULONG   FormatFlags,
  [in, optional] PCWSTR  Comment
);

Paramètres

[in, optional] FileName

Spécifie le nom du fichier de vidage à créer. FileName doit inclure l’extension de nom de fichier. FileName peut inclure un chemin relatif ou absolu ; les chemins relatifs sont relatifs au répertoire dans lequel le débogueur a été démarré. Si FileHandle n’est pas NULL, FileName est ignoré (sauf lors de l’écriture de messages d’état dans la console du débogueur).

[in] FileHandle

Spécifie le handle de fichier du fichier dans lequel écrire le vidage sur incident. Si FileHandle est NULL, le fichier spécifié dans FileName est utilisé à la place.

[in] Qualifier

Spécifie le type de vidage à créer. Pour connaître les valeurs possibles, consultez DEBUG_DUMP_XXX.

[in] FormatFlags

Spécifie des indicateurs qui déterminent le format du fichier de vidage et, pour les minidumps en mode utilisateur, les informations à inclure dans le fichier. Pour plus d’informations, consultez DEBUG_FORMAT_XXX.

[in, optional] Comment

Spécifie une chaîne de commentaire à inclure dans le fichier de vidage sur incident. Cette chaîne s’affiche dans la console du débogueur lorsque le fichier de vidage est chargé.

Valeur de retour

Cette méthode peut également retourner des valeurs d’erreur. Pour plus d’informations, consultez valeurs de retour.

Retourner le code	Description
S_OK	La méthode a réussi.

Remarques

Pour plus d’informations sur les fichiers de vidage sur incident, consultez Dump-File Targets.

Exigences

Exigence	Valeur
plateforme cible	Bureau
d’en-tête	dbgeng.h (include Dbgeng.h)

Voir aussi

.dump (Créer un fichier de vidage)

IDebugClient4

IDebugClient5

WriteDumpFile2

Partager via