PathMatchSpecExA 함수(shlwapi.h)

아티클
08/26/2023

경로의 파일 이름을 하나 이상의 파일 이름 패턴과 일치합니다.

구문

LWSTDAPI PathMatchSpecExA(
  [in] LPCSTR pszFile,
  [in] LPCSTR pszSpec,
  [in] DWORD  dwFlags
);

매개 변수

[in] pszFile

형식: LPCTSTR

일치시킬 파일 이름을 사용하는 경로를 포함하는 null로 끝나는 문자열에 대한 포인터입니다.

[in] pszSpec

형식: LPCTSTR

검색할 파일 이름 패턴을 포함하는 null로 끝나는 문자열에 대한 포인터입니다. 정확한 이름이거나 와일드카드 문자를 포함할 수 있습니다. 정확히 하나의 패턴을 지정한 경우 dwFlags에서 PMSF_NORMAL 플래그를 설정합니다. 두 개 이상의 패턴을 지정한 경우 세미콜론으로 구분하고 PMSF_MULTIPLE 플래그를 설정합니다.

[in] dwFlags

형식:DWORD

검색 조건을 수정합니다. 다음은 유효한 플래그입니다.

PMSF_NORMAL(0x00000000)

pszSpec 매개 변수는 일치시킬 단일 파일 이름 패턴을 가리킵니다.

PMSF_MULTIPLE(0x00000001)

pszSpec 매개 변수는 일치시킬 파일 이름 패턴의 세미콜론으로 구분된 목록을 가리킵니다.

PMSF_DONT_STRIP_SPACES(0x00010000)

PMSF_NORMAL 사용하는 경우 pszSpec이 가리키는 문자열의 선행 공백을 무시하지 마세요. PMSF_MULTIPLE 사용하는 경우 pszSpec에서 가리키는 문자열에 포함된 각 파일 형식의 선행 공백을 무시하지 마세요. 이 플래그는 PMSF_NORMAL 및 PMSF_MULTIPLE 결합할 수 있습니다.

반환 값

형식: HRESULT

다음 값 중 하나를 반환합니다.

반환 코드	Description
S_OK	pszSpec에 지정된 파일 이름 패턴은 pszFile이 가리키는 문자열에 있는 파일 이름과 일치합니다.
S_FALSE	pszSpec에 지정된 파일 이름 패턴이 pszFile이 가리키는 문자열에 있는 파일 이름과 일치하지 않습니다.

설명

참고

shlwapi.h 헤더는 PATHMatchSpecEx를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항


지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	shlwapi.h
라이브러리	Shlwapi.lib
DLL	Shlwapi.dll(버전 7.0 이상)

추가 정보

PathMatchSpec

다음을 통해 공유