Méthode IDebugClient2 ::OpenDumpFile (dbgeng.h)

Article
02/26/2024

La méthode OpenDumpFile ouvre un fichier de vidage en tant que cible de débogueur.

Syntaxe

HRESULT OpenDumpFile(
  [in] PCSTR DumpFile
);

Paramètres

[in] DumpFile

Spécifie le nom du fichier de vidage à ouvrir. DumpFile doit inclure l’extension de nom de fichier. DumpFile 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é. DumpFile peut avoir la forme d’une URL de fichier, commençant par « file:// ». Si DumpFile spécifie un fichier d’armoire (.cab), le fichier d’armoire est recherché pour le premier fichier avec l’extension .kdmp, puis .hdmp, puis .mdmp et enfin .dmp.

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

La version Unicode de cette méthode est OpenDumpFileWide.

Note Le moteur ne s’attache pas complètement au fichier de vidage tant que la méthode WaitForEvent n’a pas été appelée. Lorsqu’un fichier de vidage est créé à partir d’un processus ou d’un noyau, des informations sur le dernier événement sont stockées dans le fichier de vidage. Une fois le fichier de vidage ouvert, la prochaine tentative d’exécution, le moteur génère cet événement pour les rappels d’événements. Ce n’est qu’alors que le fichier de vidage devient disponible dans la session de débogage.

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