Método IDebugClient::OpenDumpFile (dbgeng.h)

Artículo
08/07/2023

El método OpenDumpFile abre un archivo de volcado como destino del depurador.

Sintaxis

HRESULT OpenDumpFile(
  [in] PCSTR DumpFile
);

Parámetros

[in] DumpFile

Especifica el nombre del archivo de volcado de memoria que se va a abrir. DumpFile debe incluir la extensión de nombre de archivo. DumpFile puede incluir una ruta de acceso relativa o absoluta; las rutas de acceso relativas son relativas al directorio en el que se inició el depurador. DumpFile puede tener la forma de una dirección URL de archivo, empezando por "file://". Si DumpFile especifica un archivo de archivador (.cab), se busca el primer archivo con la extensión .kdmp, .hdmp, .mdmp y, por último, .dmp.

Valor devuelto

Este método también puede devolver valores de error. Consulte Valores devueltos para obtener más detalles.

Código devuelto	Descripción
S_OK	Método realizado correctamente.

Comentarios

La versión Unicode de este método es OpenDumpFileWide.

Nota El motor no se asocia completamente al archivo de volcado hasta que se ha llamado al método WaitForEvent . Cuando se crea un archivo de volcado de memoria a partir de un proceso o kernel, la información sobre el último evento se almacena en el archivo de volcado de memoria. Una vez abierto el archivo de volcado, se intenta la próxima vez que se intente la ejecución, el motor generará este evento para las devoluciones de llamada de eventos. Solo entonces el archivo de volcado de memoria estará disponible en la sesión de depuración.

Para obtener más información sobre los archivos de volcado de memoria, vea Destinos de archivo de volcado de memoria.