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

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 gabinete (.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 información.

Código devuelto	Descripción
S_OK	El método se realizó correctamente.

Observaciones

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

Nota El motor no se asocia completamente al archivo de volcado hasta que se haya llamado al método waitForEvent de. 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 del evento. 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, consulte Dump-File Targets.

Requisitos

Requisito	Valor
de la plataforma de destino de	Escritorio
encabezado de	dbgeng.h (include Dbgeng.h)

Consulte también

.opendump (Abrir archivo de volcado de memoria)

AddDumpInformationFile

addDumpInformationFileWide

IDebugClient

IDebugClient2

IDebugClient3

IDebugClient4

IDebugClient5

OpenDumpFileWide