Método IDebugClient8::OpenDumpFileWide2 (dbgeng.h)
El método OpenDumpFileWide2 abre un archivo de volcado como destino del depurador.
Sintaxis
HRESULT OpenDumpFileWide2(
[in, optional] PCWSTR FileName,
[in] ULONG64 FileHandle,
[in] ULONG AlternateArch
);
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 se usa solo 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 una dirección URL de archivo, empezando por "file://". Si FileName especifica un archivo de 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 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.
[in] AlternateArch
Especifica el argumento AlternateArch que es una constante IMAGE_FILE_MACHINE_*. Para obtener más información, consulte Constantes de máquina de archivos de imagen.
Se admiten estas dos constantes.
IMAGE_FILE_MACHINE_AMD64: cargar como si la imagen se ejecuta en un proceso x64
IMAGE_FILE_MACHINE_ARM64: cargar como si la imagen se ejecuta en un proceso arm64
Este parámetro solo es relevante si usa OpenDumpFileWide2 para abrir un archivo de imagen (no un archivo de volcado) que se puede asignar a diferentes arquitecturas. Por ejemplo, ARM64X, donde el archivo DLL se puede cargar en un proceso x64/EC o en un proceso ARM64.
De forma predeterminada, se presenta información sobre el archivo DLL mediante cualquier arquitectura que hayan definido los encabezados de imagen. Si llama a OpenDumpFileWide2 con una arquitectura diferente, la información se presentará mediante la arquitectura que se pasó. Esto le permite ver las "correcciones" que el sistema operativo habría aplicado si el archivo DLL se cargara en esa arquitectura de proceso.
Para obtener más información sobre ARM64X, vea Archivos ARM64X PE.
Valor devuelto
Este método también puede devolver valores de error. Consulte Valores devueltos para obtener más detalles.
Comentarios
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.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | dbgeng.h (include Dbgeng.h) |