SymFromAddr 함수(dbghelp.h)

지정된 주소에 대한 기호 정보를 검색합니다.

구문

BOOL IMAGEAPI SymFromAddr(
  [in]            HANDLE       hProcess,
  [in]            DWORD64      Address,
  [out, optional] PDWORD64     Displacement,
  [in, out]       PSYMBOL_INFO Symbol
);

매개 변수

[in] hProcess

프로세스에 대한 핸들입니다. 이 핸들은 이전에 SymInitialize 함수에 전달되어야 합니다.

[in] Address

기호를 배치해야 하는 주소입니다. 주소가 기호 경계에 있을 필요는 없습니다. 주소가 기호의 시작 후와 기호의 끝 앞에 오는 경우 기호를 찾습니다.

[out, optional] Displacement

기호의 시작 부분에서의 변위 또는 0입니다.

[in, out] Symbol

기호에 대한 정보를 제공하는 SYMBOL_INFO 구조체에 대한 포인터입니다. 기호 이름은 길이가 가변적입니다. 따라서 이 버퍼는 SYMBOL_INFO 구조체의 끝에 저장된 이름을 저장할 수 있을 만큼 커야 합니다. MaxNameLen 멤버를 이름에 예약된 바이트 수로 설정해야 합니다.

반환 값

함수가 성공하면 반환 값은 TRUE입니다.

함수가 실패하면 반환 값은 FALSE입니다. 확장된 오류 정보를 검색하려면 GetLastError를 호출합니다.

설명

이 함수와 같은 모든 DbgHelp 함수는 단일 스레드입니다. 따라서 둘 이상의 스레드에서 이 함수로 호출하면 예기치 않은 동작이나 메모리 손상이 발생할 수 있습니다. 이를 방지하려면 둘 이상의 스레드에서 이 함수로의 모든 동시 호출을 동기화해야 합니다.

이 함수의 유니코드 버전을 호출하려면 DBGHELP_TRANSLATE_TCHAR 정의합니다.

예제

예제는 주소별 기호 정보 검색을 참조하세요.

요구 사항

추가 정보

DbgHelp 함수

SYMBOL_INFO