영어로 읽기

다음을 통해 공유

PSYM_ENUMSYMBOLS_CALLBACK64 콜백 함수(dbghelp.h)

  • 아티클

SymEnumerateSymbols64 함수와 함께 사용되는 애플리케이션 정의 콜백 함수입니다. 열거된 각 기호에 대해 한 번 호출되고 기호 정보를 받습니다.

PSYM_ENUMSYMBOLS_CALLBACK64 및 PSYM_ENUMSYMBOLS_CALLBACK64W 형식은 이 콜백 함수에 대한 포인터를 정의합니다. SymEnumerateSymbolsProc64 는 애플리케이션 정의 함수 이름의 자리 표시자입니다.

참고 이 함수는 호환성을 위해서만 제공됩니다. 애플리케이션은 SymEnumSymbols를 사용해야 합니다.
 

구문

PSYM_ENUMSYMBOLS_CALLBACK64 PsymEnumsymbolsCallback64;

BOOL PsymEnumsymbolsCallback64(
  [in]           PCSTR SymbolName,
  [in]           DWORD64 SymbolAddress,
  [in]           ULONG SymbolSize,
  [in, optional] PVOID UserContext
)
{...}

매개 변수

[in] SymbolName

기호 이름입니다. SYMOPT_UNDNAME 옵션을 SymSetOptions 함수와 함께 사용하는 경우 이름을 해독할 수 있습니다.

[in] SymbolAddress

기호의 시작 부분에 대한 가상 주소입니다.

[in] SymbolSize

기호의 크기(바이트)입니다. 크기가 계산되고 실제로 가장 적합한 값입니다. 경우에 따라 값이 0일 수 있습니다.

[in, optional] UserContext

SymEnumerateSymbols64 또는 NULL에 지정된 사용자 정의 값입니다. 일반적으로 이 매개 변수는 애플리케이션에서 콜백 함수가 일부 유형의 컨텍스트를 설정할 수 있는 데이터 구조에 대한 포인터를 전달하는 데 사용됩니다.

반환 값

함수가 TRUE를 반환하면 열거형이 계속됩니다.

함수가 FALSE를 반환하면 열거형이 중지됩니다.

설명

호출 애플리케이션은 모든 기호가 열거되거나 열거형 콜백 함수가 FALSE를 반환할 때까지 기호당 한 번 호출됩니다.

이 콜백 함수는 PSYM_ENUMSYMBOLS_CALLBACK 콜백 함수를 대체합니다. PSYM_ENUMSYMBOLS_CALLBACK Dbghelp.h에서 다음과 같이 정의됩니다.

#if !defined(_IMAGEHLP_SOURCE_) && defined(_IMAGEHLP64)
#define PSYM_ENUMSYMBOLS_CALLBACK PSYM_ENUMSYMBOLS_CALLBACK64
#define PSYM_ENUMSYMBOLS_CALLBACKW PSYM_ENUMSYMBOLS_CALLBACK64W
#else
typedef BOOL
(CALLBACK *PSYM_ENUMSYMBOLS_CALLBACK)(
    __in PCSTR SymbolName,
    __in ULONG SymbolAddress,
    __in ULONG SymbolSize,
    __in_opt PVOID UserContext
    );

typedef BOOL
(CALLBACK *PSYM_ENUMSYMBOLS_CALLBACKW)(
    __in PCWSTR SymbolName,
    __in ULONG SymbolAddress,
    __in ULONG SymbolSize,
    __in_opt PVOID UserContext
    );
#endif

요구 사항

요구 사항 값
대상 플랫폼 Windows
헤더 dbghelp.h
재배포 가능 파일 DbgHelp.dll 5.1 이상

추가 정보

DbgHelp 함수

SymEnumSymbols

SymEnumerateSymbols64