Méthode IDebugClient4 ::WriteDumpFileWide (dbgeng.h)

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 d’accès relatif ou absolu ; les chemins relatifs sont relatifs au répertoire dans lequel le débogueur a été démarré. Si FileHandle n’a pas la valeur NULL, FileName est ignoré (sauf lors de l’écriture de messages status 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 a la valeur 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 les 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 retournée

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

Code de retour	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.

Configuration requise

Condition requise	Valeur
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	dbgeng.h (inclure Dbgeng.h)

Voir aussi

.dump (Créer un fichier de vidage)

IDebugClient4

IDebugClient5

WriteDumpFile2