IDebugSymbols3::GetModuleNameString 메서드(dbgeng.h)

GetModuleNameString 메서드는 지정된 모듈의 이름을 반환합니다.

구문

HRESULT GetModuleNameString(
  [in]            ULONG   Which,
  [in]            ULONG   Index,
  [in]            ULONG64 Base,
  [out, optional] PSTR    Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  NameSize
);

매개 변수

[in] Which

반환할 모듈 이름을 지정합니다. 가능한 값은 다음과 같습니다.

값	Description
DEBUG_MODNAME_IMAGE	이미지 이름입니다. 확장명을 포함하여 실행 파일의 이름입니다. 일반적으로 전체 경로는 사용자 모드에 포함되지만 커널 모드에는 포함되지 않습니다.
DEBUG_MODNAME_MODULE	모듈 이름입니다. 일반적으로 확장명을 사용하지 않는 파일 이름일 뿐입니다. 경우에 따라 모듈 이름이 파일 이름과 크게 다릅니다.
DEBUG_MODNAME_LOADED_IMAGE	로드된 이미지 이름입니다. Microsoft CodeView 기호가 없으면 이미지 이름과 동일합니다.
DEBUG_MODNAME_SYMBOL_FILE	기호 파일 이름입니다. 기호 파일의 경로 및 이름입니다. 기호가 로드되지 않은 경우 대신 실행 파일의 이름입니다.
DEBUG_MODNAME_MAPPED_IMAGE	매핑된 이미지 이름입니다. 대부분의 경우 NULL입니다. 디버거가 이미지 파일을 매핑하는 경우(예: 미니덤프 디버깅 중) 매핑된 이미지의 이름입니다.

[in] Index

모듈의 인덱스를 지정합니다. DEBUG_ANY_ID 로 설정된 경우 Base 매개 변수를 사용하여 모듈의 위치를 대신 지정합니다.

[in] Base

Index가 DEBUG_ANY_ID 경우 는 모듈 기반의 대상 메모리 주소 공간에 있는 위치를 지정합니다. 그렇지 않으면 무시됩니다.

[out, optional] Buffer

모듈의 이름을 받습니다. Buffer가 NULL이면 이 정보가 반환되지 않습니다.

[in] BufferSize

버 퍼 버퍼의 문자 크기를 지정합니다. 이 크기에는 '\0' 종료 문자의 공간이 포함됩니다.

[out, optional] NameSize

모듈 이름의 문자로 크기를 받습니다. 이 크기에는 '\0' 종료 문자의 공간이 포함됩니다. NameSize가 NULL이면 이 정보가 반환되지 않습니다.

반환 값

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

반환 코드	Description
S_OK	메서드를 성공적으로 수행했습니다.
S_FALSE	메서드를 성공적으로 수행했습니다. 그러나 버퍼의 크기가 모듈 이름의 크기보다 작으므로 버퍼에 맞게 잘렸습니다.

설명

모듈에 대한 자세한 내용은 모듈을 참조하세요.

요구 사항

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

추가 정보

GetModuleNames

IDebugSymbols2

IDebugSymbols3