FindExecutableImageEx 함수(dbghelp.h)

지정된 실행 파일을 찾습니다.

구문

HANDLE IMAGEAPI FindExecutableImageEx(
  [in]           PCSTR                   FileName,
  [in]           PCSTR                   SymbolPath,
  [out]          PSTR                    ImageFilePath,
  [in, optional] PFIND_EXE_FILE_CALLBACK Callback,
  [in, optional] PVOID                   CallerData
);

매개 변수

[in] FileName

찾을 기호 파일의 이름입니다. 이 매개 변수는 부분 경로일 수 있습니다.

[in] SymbolPath

기호 파일이 있는 경로입니다. 이 문자열에는 세미콜론으로 구분된 여러 경로가 포함될 수 있습니다. 기호 경로를 검색하려면 SymGetSearchPath 함수를 사용합니다.

[out] ImageFilePath

실행 파일의 전체 경로를 수신하는 버퍼에 대한 포인터입니다.

[in, optional] Callback

올바른 실행 파일이 발견되었는지 또는 함수가 검색을 계속해야 하는지 여부를 확인하는 애플리케이션 정의 콜백 함수입니다. 자세한 내용은 FindExecutableImageProc을 참조하세요.

이 매개 변수는 NULL일 수 있습니다.

[in, optional] CallerData

콜백 함수에 대한 선택적 사용자 정의 데이터입니다. 이 매개 변수는 NULL일 수 있습니다.

반환 값

함수가 성공하면 반환 값은 실행 파일에 대한 열린 핸들입니다.

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

설명

FindExecutableImageEx 함수는 단일 함수 호출을 사용하여 여러 디렉터리에서 실행 파일을 찾을 수 있도록 제공됩니다. SymbolPath 매개 변수에 여러 경로가 포함된 경우 함수는 지정된 각 디렉터리 트리에서 실행 파일을 검색합니다. 파일이 발견되면 검색이 중지됩니다. 따라서 경로가 올바른 순서로 SymbolPath 를 지정해야 합니다.

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

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

요구 사항

추가 정보

DbgHelp 함수

FindExecutableImageProc

SymGetSearchPath