IDebugClient5 ::OpenDumpFileWide, méthode (dbgeng.h)

Article
02/06/2025

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

Syntaxe

HRESULT OpenDumpFileWide(
  [in, optional] PCWSTR  FileName,
  [in]           ULONG64 FileHandle
);

Paramètres

[in, optional] FileName

Spécifie le nom du fichier de vidage à ouvrir , sauf si FileHandle n’est pas zéro, auquel cas FileName est utilisé uniquement lorsque le moteur est interrogé pour le nom du fichier de vidage. 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é. fileName peut également être sous la forme d’une URL de fichier, en commençant par « file:// ». Si FileName 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.

[in] FileHandle

Spécifie le handle de fichier du fichier de vidage à ouvrir. Si FileHandle est égal à zéro, nom_fichier est utilisé pour ouvrir le fichier de vidage. Sinon, si fileName n’est pas NULL, le moteur le retourne lorsqu’il est interrogé pour le nom du fichier de vidage. Si FileHandle n’est pas zéro et fileName est NULL, le moteur retourne HandleOnly pour le nom de fichier.

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

La version ASCII de cette méthode est OpenDumpFile.

Remarque Le moteur n’est pas entièrement attaché 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 fois que l’exécution est tentée, le moteur génère cet événement pour les rappels d’événements. Seul 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.