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

WriteDumpFile 메서드는 사용자 모드 또는 커널 모드크래시 덤프 파일을 만듭니다.

구문

HRESULT WriteDumpFile(
  [in] PCSTR DumpFile,
  [in] ULONG Qualifier
);

[in] DumpFile

만들 덤프 파일의 이름을 지정합니다. DumpFile 에는 파일 이름 확장명을 포함해야 합니다. DumpFile 에는 상대 경로 또는 절대 경로가 포함될 수 있습니다. 상대 경로는 디버거가 시작된 디렉터리를 기준으로 합니다.

[in] Qualifier

만들 덤프 파일의 형식을 지정합니다. 가능한 값은 비고를 참조하세요.

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

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

DEBUG_DUMP_XXX 상수는 WriteDumpFile, WriteDumpFile2 및 WriteDumpFileWide 메서드에서 생성할 크래시 덤프 파일의 형식을 지정하는 데 사용됩니다.

가능한 값은 다음과 같습니다.

상수	Description
DEBUG_DUMP_SMALL	작은 메모리 덤프(커널 모드) 또는 미니덤프(사용자 모드)를 만듭니다.
DEBUG_DUMP_DEFAULT	전체 User-Mode 덤프(사용자 모드) 또는 커널 요약 덤프(커널 모드)를 만듭니다.
DEBUG_DUMP_FULL	전체 메모리 덤프를 만듭니다(커널 모드에만 해당).

파일의 서식을 지정하고 사용자 모드 미니덤프의 경우 파일에 포함할 정보를 지정하려면 WriteDumpFile2 또는 WriteDumpFileWide를 사용합니다.

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

또한 커널 모드 디버깅에 사용할 수 있는 별칭은 다음과 같습니다.

또한 다음 별칭을 사용자 모드 디버깅에 사용할 수 있습니다.

Alias	값
DEBUG_USER_WINDOWS_SMALL_DUMP	DEBUG_DUMP_SMALL
DEBUG_USER_WINDOWS_DUMP	DEBUG_DUMP_DEFAULT

요구 사항	값
대상 플랫폼	데스크톱
머리글	dbgeng.h(Dbgeng.h 포함)