IDebugSymbols2::GetModuleNames 메서드(dbgeng.h)

아티클
08/07/2023

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

구문

HRESULT GetModuleNames(
  [in]            ULONG   Index,
  [in]            ULONG64 Base,
  [out, optional] PSTR    ImageNameBuffer,
  [in]            ULONG   ImageNameBufferSize,
  [out, optional] PULONG  ImageNameSize,
  [out, optional] PSTR    ModuleNameBuffer,
  [in]            ULONG   ModuleNameBufferSize,
  [out, optional] PULONG  ModuleNameSize,
  [out, optional] PSTR    LoadedImageNameBuffer,
  [in]            ULONG   LoadedImageNameBufferSize,
  [out, optional] PULONG  LoadedImageNameSize
);

매개 변수

[in] Index

이름이 요청되는 모듈의 인덱스를 지정합니다. DEBUG_ANY_ID 로 설정된 경우 모듈은 Base로 지정됩니다.

[in] Base

이름이 요청된 모듈의 기본 주소를 지정합니다. 이 매개 변수는 Index 가 DEBUG_ANY_ID 설정된 경우에만 사용됩니다.

[out, optional] ImageNameBuffer

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

[in] ImageNameBufferSize

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

[out, optional] ImageNameSize

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

[out, optional] ModuleNameBuffer

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

[in] ModuleNameBufferSize

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

[out, optional] ModuleNameSize

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

[out, optional] LoadedImageNameBuffer

모듈의 로드된 이미지 이름을 받습니다. LoadedImageNameBuffer가 NULL이면 이 정보가 반환되지 않습니다.

[in] LoadedImageNameBufferSize

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

[out, optional] LoadedImageNameSize

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

반환 값

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

반환 코드	Description
S_OK	메서드를 성공적으로 수행했습니다.
S_FALSE	메서드를 성공적으로 수행했습니다. 그러나 ImageNameBuffer, ModuleNameBuffer 또는 LoadedImageNameBuffer 중 하나 이상이 해당 이름에 비해 너무 작아서 잘렸습니다.
E_NOINTERFACE	지정한 모듈을 찾을 수 없습니다.