EnumDirTree 함수(dbghelp.h)
지정된 디렉터리 트리에서 지정된 파일의 모든 발생을 열거합니다.
구문
BOOL IMAGEAPI EnumDirTree(
[in, optional] HANDLE hProcess,
[in] PCSTR RootPath,
[in] PCSTR InputPathName,
[out, optional] PSTR OutputPathBuffer,
[in, optional] PENUMDIRTREE_CALLBACK cb,
[in, optional] PVOID data
);
매개 변수
[in, optional] hProcess
프로세스에 대한 핸들입니다. 이 핸들은 이전에 SymInitialize 함수에 전달되어야 합니다.
[in] RootPath
함수가 파일 검색을 시작해야 하는 경로입니다.
[in] InputPathName
찾을 파일의 이름입니다. 부분 경로를 지정할 수 있습니다.
[out, optional] OutputPathBuffer
파일의 전체 경로를 수신하는 버퍼에 대한 포인터입니다. 함수가 실패하거나 일치하는 파일을 찾지 못하는 경우 이 버퍼에는 발견된 마지막 전체 경로가 계속 포함됩니다.
이 매개 변수는 선택 사항이며 NULL일 수 있습니다.
[in, optional] cb
애플리케이션 정의 콜백 함수 또는 NULL입니다. 자세한 내용은 EnumDirTreeProc을 참조하세요.
[in, optional] data
사용자 정의 데이터 또는 NULL입니다. 이 값은 콜백 함수에 전달됩니다.
반환 값
함수가 성공하면 반환 값은 TRUE입니다.
함수가 실패하면 반환 값은 FALSE입니다. 확장된 오류 정보를 검색하려면 GetLastError를 호출합니다.
설명
SymRegisterCallbackProc64 콜백 함수를 등록하면 검색을 취소할 수 있습니다. 모든 파일 작업에 대해 EnumDirTree 는 CBA_DEFERRED_SYMBOL_LOAD_CANCEL 사용하여 이 콜백 함수를 호출합니다. 콜백 함수가 TRUE를 반환하면 EnumDirTree 가 검색을 취소합니다.
이 함수와 같은 모든 DbgHelp 함수는 단일 스레드입니다. 따라서 둘 이상의 스레드에서 이 함수로 호출하면 예기치 않은 동작이나 메모리 손상이 발생할 수 있습니다. 이를 방지하려면 둘 이상의 스레드에서 이 함수로의 모든 동시 호출을 동기화해야 합니다.
이 함수의 유니코드 버전을 호출하려면 DBGHELP_TRANSLATE_TCHAR 정의합니다.
요구 사항
| 대상 플랫폼 | Windows |
| 헤더 | dbghelp.h |
| 라이브러리 | Dbghelp.lib |
| DLL | Dbghelp.dll |
| 재배포 가능 파일 | DbgHelp.dll 6.0 이상 |