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

Artículo
02/26/2024

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 tener la forma de una dirección URL de archivo, empezando por "file://". Si FileName especifica un archivo archivador (.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 detalles.

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

Comentarios

La versión ASCII de este método es OpenDumpFile.

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 de memoria, 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, vea Destinos de archivo de volcado de memoria.