Método IDebugClient5::OpenDumpFileWide (dbgeng.h)

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

Sintaxis

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

Parámetros

[in, optional] FileName

Especifica el nombre del archivo de volcado de memoria que se va a abrir, a menos que FileHandle no sea cero, en cuyo caso FileName solo se usa cuando se consulta el motor para el nombre del archivo de volcado. fileName debe incluir la extensión de nombre de archivo. FileName 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. fileName también puede estar en forma de dirección URL de archivo, empezando por "file://". Si FileName especifica un archivo de gabinete (.cab), se busca el primer archivo con la extensión .kdmp, .hdmp, .mdmp y, por último, .dmp.

[in] FileHandle

Especifica el identificador de archivo del archivo de volcado de memoria que se va a abrir. Si FileHandle es cero, fileName se usa para abrir el archivo de volcado. De lo contrario, si fileName no es NULL, el motor lo devuelve cuando se consulta el nombre del archivo de volcado. Si FileHandle no es cero y fileName es NULL, el motor devolverá handleOnly para el nombre de archivo.

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 ASCII de este método es OpenDumpFile.

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

IDebugClient4

IDebugClient5

OpenDumpFile