IDebugClient5::OpenDumpFileWide 메서드(dbgeng.h)

아티클
02/26/2024

OpenDumpFileWide 메서드는 덤프 파일을 디버거 대상으로 엽니다.

구문

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

매개 변수

[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를 반환합니다.

반환 값

이 메서드는 오류 값을 반환할 수도 있습니다. 자세한 내용은 반환 값을 참조하세요 .

반환 코드	Description
S_OK	메서드를 성공적으로 수행했습니다.

설명

이 메서드의 ASCII 버전은 OpenDumpFile입니다.

참고WaitForEvent 메서드가 호출될 때까지 엔진이 덤프 파일에 완전히 연결되지 않습니다. 프로세스 또는 커널에서 덤프 파일을 만들면 마지막 이벤트에 대한 정보가 덤프 파일에 저장됩니다. 덤프 파일을 연 후 다음에 실행이 시도되면 엔진은 이벤트 콜백에 대해 이 이벤트를 생성합니다. 그런 후에만 덤프 파일을 디버깅 세션에서 사용할 수 있게 됩니다.

크래시 덤프 파일에 대한 자세한 내용은 덤프 파일 대상을 참조하세요.