IDebugSymbols3::GetNearNameByOffset 메서드(dbgeng.h)
GetNearNameByOffset 메서드는 지정된 위치 근처에 있는 기호의 이름을 반환합니다.
통사론
HRESULT GetNearNameByOffset(
[in] ULONG64 Offset,
[in] LONG Delta,
[out, optional] PSTR NameBuffer,
[in] ULONG NameBufferSize,
[out, optional] PULONG NameSize,
[out, optional] PULONG64 Displacement
);
매개 변수
[in] Offset
원하는 기호가 결정되는 기호의 대상 가상 주소 공간 위치를 지정합니다.
[in] Delta
원하는 기호와 Offset있는 기호 간의 관계를 지정합니다. 양수이면 엔진은 Offset있는 기호 다음에 델타 기호를 기호를 반환합니다. 음수이면 엔진은 Offset있는 기호 앞에 델타 기호를 기호를 반환합니다.
[out, optional] NameBuffer
기호의 이름을 받습니다. 이름은 기호가 속한 모듈(예: mymodule!main )에 의해 정규화됩니다. NameBuffer NULL 경우 이 정보가 반환되지 않습니다.
[in] NameBufferSize
NameBuffer 버퍼문자의 크기를 지정합니다. 이 크기에는 '\0' 종료 문자의 공간이 포함됩니다.
[out, optional] NameSize
기호 이름의 문자로 크기를 받습니다. 이 크기에는 '\0' 종료 문자의 공간이 포함됩니다. NameSize NULL 경우 이 정보가 반환되지 않습니다.
[out, optional] Displacement
Offset 값과 기호의 대상 메모리 주소 공간에 있는 위치 간의 차이를 받습니다. 변위 NULL 경우 이 정보가 반환되지 않습니다.
반환 값
이 메서드는 다른 오류 값도 반환할 수 있습니다. 자세한 내용은 반환 값 참조하세요.
| 반환 코드 | 묘사 |
|---|---|
|
메서드가 성공했습니다. |
|
메서드가 성공했습니다. 그러나 버퍼가 기호의 이름을 저장할 만큼 충분히 크지 않아 잘렸습니다. |
|
Offset 및 Delta 사양과 일치하는 기호를 찾을 수 없습니다. |
발언
delta 값을 늘리거나 줄이면 이러한 메서드를 사용하여 특정 위치에서 시작하는 대상의 기호를 반복할 수 있습니다.
Delta 0이면 이러한 메서드는 getNameByOffset 동일한 방식으로 작동합니다.
기호 및 기호 이름에 대한 자세한 내용은 기호참조하세요.
요구 사항
| 요구 | 값 |
|---|---|
| 대상 플랫폼 | 바탕 화면 |
| 헤더 | dbgeng.h(Dbgeng.h 포함) |