IDebugClient8::OpenDumpFileWide2 메서드(dbgeng.h)
OpenDumpFileWide2 메서드는 덤프 파일을 디버거 대상으로 엽니다.
통사론
HRESULT OpenDumpFileWide2(
[in, optional] PCWSTR FileName,
[in] ULONG64 FileHandle,
[in] ULONG AlternateArch
);
매개 변수
[in, optional] FileName
열 덤프 파일의 이름을 지정합니다. FileHandle 0이 아니면 엔진이 덤프 파일의 이름을 쿼리할 때만 FileName 사용됩니다. FileName 파일 이름 확장명을 포함해야 합니다. FileName 상대 또는 절대 경로를 포함할 수 있습니다. 상대 경로는 디버거가 시작된 디렉터리를 기준으로 합니다. FileName "file://"부터 파일 URL 형식일 수도 있습니다. FileName 캐비닛(.cab) 파일을 지정하는 경우 캐비닛 파일은 확장명 .kdmp, .hdmp, .mdmp를 사용하여 첫 번째 파일을 검색하고 마지막으로 .dmp.
[in] FileHandle
열 덤프 파일의 파일 핸들을 지정합니다. FileHandle 0이면 FileName 사용하여 덤프 파일을 엽니다. 그렇지 않은 경우 FileName NULL 않으면 엔진은 덤프 파일의 이름을 쿼리할 때 반환합니다. FileHandle 0이 아니고 FileName NULL 경우 엔진은 파일 이름에 대한 HandleOnly 반환합니다.
[in] AlternateArch
IMAGE_FILE_MACHINE_* 상수인 AlternateArch 인수를 지정합니다. 자세한 내용은 이미지 파일 컴퓨터 상수 참조하세요.
이러한 두 상수가 지원됩니다.
IMAGE_FILE_MACHINE_AMD64: 이미지가 x64 프로세스에서 실행되는 것처럼 로드
IMAGE_FILE_MACHINE_ARM64: 이미지가 ARM64 프로세스에서 실행되는 것처럼 로드
이 매개 변수는 OpenDumpFileWide2를 사용하여 다른 아키텍처에 매핑할 수 있는 이미지 파일(덤프 파일이 아님)을 여는 경우에만 관련이 있습니다. 예를 들어 DLL을 x64/EC 프로세스 또는 ARM64 프로세스로 로드할 수 있는 ARM64X입니다.
기본적으로 DLL에 대한 정보는 이미지 헤더가 정의한 아키텍처를 사용하여 표시됩니다. 다른 아키텍처를 사용하여 OpenDumpFileWide2를 호출하면 전달된 아키텍처를 사용하여 정보가 표시됩니다. 이렇게 하면 DLL이 해당 프로세스 아키텍처에 로드된 경우 OS가 적용했을 "수정"을 볼 수 있습니다.
ARM64X에 대한 자세한 내용은 Arm64X PE 파일참조하세요.
반환 값
이 메서드는 오류 값을 반환할 수도 있습니다. 자세한 내용은 반환 값 참조하세요.
발언
WaitForEvent 메서드가 호출될 때까지 엔진이 덤프 파일에 완전히 연결되지 않습니다. 프로세스 또는 커널에서 덤프 파일을 만들면 마지막 이벤트에 대한 정보가 덤프 파일에 저장됩니다. 덤프 파일을 연 후 다음에 실행이 시도되면 엔진은 이벤트 콜백에 대해 이 이벤트를 생성합니다. 그런 후에만 덤프 파일을 디버깅 세션에서 사용할 수 있게 됩니다.
크래시 덤프 파일에 대한 자세한 내용은 Dump-File 대상참조하세요.
요구 사항
| 요구 | 값 |
|---|---|
| 대상 플랫폼 | Windows |
| 헤더 | dbgeng.h(Dbgeng.h 포함) |