SymMatchFileName 함수(dbghelp.h)

문자열을 파일 이름 및 경로와 비교합니다.

구문

BOOL IMAGEAPI SymMatchFileName(
  [in]            PCSTR FileName,
  [in]            PCSTR Match,
  [out, optional] PSTR  *FileNameStop,
  [out, optional] PSTR  *MatchStop
);

매개 변수

[in] FileName

Match 매개 변수와 비교할 파일 이름입니다.

[in] Match

FileName 매개 변수와 비교할 문자열입니다.

[out, optional] FileNameStop

일치하는 항목이 중지된 FileName 의 위치에 대한 포인터를 수신하는 문자열 버퍼에 대한 포인터입니다. 전체 일치의 경우 이 값은 FileName 앞에 한 문자가 될 수 있습니다. 이 값은 NULL일 수도 있습니다.

[out, optional] MatchStop

일치에서 일치가 중지된 위치에 대한 포인터를 수신하는 문자열 버 퍼에 대한 포인터입니다. 전체 일치의 경우 이 값은 일치 이전의 한 문자일 수 있습니다. 이 값은 NULL일 수 있습니다.

반환 값

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

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

설명

일치 문자열은 전체 파일 이름의 접미사일 수 있으므로 이 함수를 사용하여 일반 파일 이름을 정규화된 파일 이름과 일치시킬 수 있습니다.

일치는 두 문자열의 끝에서 시작하여 뒤로 진행됩니다. 일치는 대/소문자를 구분하지 않으며 백슬래시(\)와 슬래시(/)와 동일합니다.

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

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

요구 사항

추가 정보

DbgHelp 함수