SymEnumSymbols 함수(dbghelp.h)
프로세스의 모든 기호를 열거합니다.
구문
BOOL IMAGEAPI SymEnumSymbols(
[in] HANDLE hProcess,
[in] ULONG64 BaseOfDll,
[in, optional] PCSTR Mask,
[in] PSYM_ENUMERATESYMBOLS_CALLBACK EnumSymbolsCallback,
[in, optional] PVOID UserContext
);
매개 변수
[in] hProcess
프로세스에 대한 핸들입니다. 이 핸들은 이전에 SymInitialize 함수에 전달되어야 합니다.
[in] BaseOfDll
모듈의 기본 주소입니다. 이 값이 0이고 Mask 에 느낌표(!)가 포함된 경우 함수는 모듈을 살펴봅니다. 이 값이 0이고 Mask에 느낌표가 없는 경우 함수는 SymSetContext 함수에 의해 설정된 scope 사용합니다.
[in, optional] Mask
열거할 기호의 이름을 나타내는 와일드카드 문자열입니다. 텍스트는 필요에 따라 와일드카드 "*" 및 "?"를 포함할 수 있습니다.
특정 모듈 또는 모듈 집합을 지정하려면 모듈을 지정하는 와일드카드 문자열과 느낌표로 텍스트를 시작합니다. 모듈을 지정할 때 BaseOfDll 은 무시됩니다.
| 값 | 의미 |
|---|---|
|
BaseOfDll이 0이 아닌 경우 SymEnumSymbols는 "foo"라는 전역 기호를 찾습니다.
BaseOfDll이 0이면 SymEnumSymbols는 SymSetContext 함수에 대한 최신 호출에 의해 설정된 scope 내에서 "foo"라는 로컬 기호를 찾습니다. |
|
BaseOfDll이 0이 아닌 경우 SymEnumSymbols는 "foo"로 시작하고 나중에 "바보"와 "발"과 같은 하나의 추가 문자를 포함하는 전역 기호를 찾습니다.
BaseOfDll이 0이면 SymEnumSymbols는 "foo"로 시작하고 나중에 "바보"와 "발"과 같은 하나의 추가 문자를 포함하는 기호를 찾습니다. 검색은 SymSetContext 함수에 대한 최신 호출에 의해 설정된 scope 내에 있습니다. |
|
SymEnumSymbols 는 "bar"라는 기호에 대한 텍스트 "foo"로 시작하는 로드된 모든 모듈에서 표시됩니다. "foot!bar", "footlocker!bar", "fool!bar"와 같은 일치 항목을 찾을 수 있습니다. |
|
SymEnumSymbols 는 로드된 모든 모듈의 모든 기호를 열거합니다. |
[in] EnumSymbolsCallback
기호 정보를 수신하는 SymEnumSymbolsProc 콜백 함수입니다.
[in, optional] UserContext
콜백 함수 또는 NULL에 전달되는 사용자 정의 값입니다. 이 매개 변수는 일반적으로 애플리케이션에서 콜백 함수에 대한 컨텍스트를 제공하는 데이터 구조에 대한 포인터를 전달하는 데 사용됩니다.
반환 값
함수가 성공하면 반환 값은 TRUE입니다.
함수가 실패하면 반환 값은 FALSE입니다. 확장된 오류 정보를 검색하려면 GetLastError를 호출합니다.
설명
이 함수와 같은 모든 DbgHelp 함수는 단일 스레드입니다. 따라서 둘 이상의 스레드에서 이 함수로 호출하면 예기치 않은 동작이나 메모리 손상이 발생할 수 있습니다. 이를 방지하려면 둘 이상의 스레드에서 이 함수로의 모든 동시 호출을 동기화해야 합니다.
이 함수의 유니코드 버전을 호출하려면 DBGHELP_TRANSLATE_TCHAR 정의합니다.
예제
예제는 기호 열거를 참조하세요.
요구 사항
| 대상 플랫폼 | Windows |
| 헤더 | dbghelp.h |
| 라이브러리 | Dbghelp.lib |
| DLL | Dbghelp.dll |
| 재배포 가능 파일 | DbgHelp.dll 5.1 이상 |