SearchTreeForFile 함수(dbghelp.h)

디렉터리 트리에서 지정된 파일을 검색합니다.

구문

BOOL IMAGEAPI SearchTreeForFile(
  [in]  PCSTR RootPath,
  [in]  PCSTR InputPathName,
  [out] PSTR  OutputPathBuffer
);

매개 변수

[in] RootPath

함수가 파일 검색을 시작해야 하는 경로입니다.

[in] InputPathName

함수가 검색할 파일입니다. 부분 경로를 사용할 수 있습니다.

[out] OutputPathBuffer

찾은 파일에 대한 전체 경로를 수신하는 버퍼에 대한 포인터입니다. 반환 값이 FALSE이면 이 문자열은 수정되지 않습니다.

반환 값

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

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

설명

함수는 RootPath 매개 변수에 지정된 경로부터 InputPathName 매개 변수로 지정된 파일을 검색합니다. RootPath에서 허용되는 최대 경로 깊이는 32개 디렉터리입니다. 함수는 디렉터리 트리에서 파일을 찾으면 OutputPathBuffer 매개 변수로 지정된 버퍼에 파일의 전체 경로를 배치합니다. 기본 파일 시스템은 하위 디렉터리 검색의 순서를 지정합니다.

SymRegisterCallbackProc64 콜백 함수를 등록하면 검색을 취소할 수 있습니다. 검색된 모든 디렉터리에 대해 SearchTreeForFile 은 CBA_DEFERRED_SYMBOL_LOAD_CANCEL 사용하여 이 콜백 함수를 호출합니다. 콜백 함수가 TRUE를 반환하면 SearchTreeForFile 에서 검색을 취소합니다.

이 함수는 검색된 디렉터리당 하나의 CBA_DEFERRED_SYMBOL_LOAD_CANCEL 이벤트를 트리거합니다. 이렇게 하면 호출자가 검색을 취소할 수 있습니다.

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

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

요구 사항

추가 정보

DbgHelp 함수