SymEnumerateSymbols 함수(dbghelp.h)

아티클
08/23/2023

지정된 모듈의 모든 기호를 열거합니다.

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

구문

DBHLP_DEPRECIATED BOOL IMAGEAPI SymEnumerateSymbols(
  [in]           HANDLE                    hProcess,
  [in]           ULONG                     BaseOfDll,
  [in]           PSYM_ENUMSYMBOLS_CALLBACK EnumSymbolsCallback,
  [in, optional] PVOID                     UserContext
);

매개 변수

[in] hProcess

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

[in] BaseOfDll

기호를 열거할 모듈의 기본 주소입니다.

[in] EnumSymbolsCallback

기호 정보를 수신하는 콜백 함수입니다. 자세한 내용은 SymEnumerateSymbolsProc64를 참조하세요.

[in, optional] UserContext

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

반환 값

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

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

설명

SymEnumerateSymbols64 함수는 지정된 모듈에 대한 모든 기호를 열거합니다. 모듈 정보는 BaseOfDll 매개 변수에 의해 있습니다. 콜백 함수는 기호당 한 번 호출되며 각 기호에 대한 정보가 전달됩니다.

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

이 함수의 유니코드 버전 인 SymEnumerateSymbolsW64 는 Dbghelp.h에서 다음과 같이 정의됩니다.


BOOL
IMAGEAPI
SymEnumerateSymbolsW64(
    __in HANDLE hProcess,
    __in ULONG64 BaseOfDll,
    __in PSYM_ENUMSYMBOLS_CALLBACK64W EnumSymbolsCallback,
    __in_opt PVOID UserContext
    );

이 함수는 SymEnumerateSymbols 함수를 대체합니다 . 자세한 내용은 업데이트된 플랫폼 지원을 참조하세요. SymEnumerateSymbols 는 Dbghelp.h에서 다음과 같이 정의됩니다.

#if !defined(_IMAGEHLP_SOURCE_) && defined(_IMAGEHLP64)
#define SymEnumerateSymbols SymEnumerateSymbols64
#define SymEnumerateSymbolsW SymEnumerateSymbolsW64
#else
BOOL
IMAGEAPI
SymEnumerateSymbols(
    __in HANDLE hProcess,
    __in ULONG BaseOfDll,
    __in PSYM_ENUMSYMBOLS_CALLBACK EnumSymbolsCallback,
    __in_opt PVOID UserContext
    );

BOOL
IMAGEAPI
SymEnumerateSymbolsW(
    __in HANDLE hProcess,
    __in ULONG BaseOfDll,
    __in PSYM_ENUMSYMBOLS_CALLBACKW EnumSymbolsCallback,
    __in_opt PVOID UserContext
    );
#endif