PathResolve 함수(shlobj_core.h)
[PathResolve 는 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다.]
상대 또는 정규화되지 않은 경로 이름을 정규화된 경로 이름으로 변환합니다.
구문
int PathResolve(
[in, out] PWSTR pszPath,
[in, optional] PZPCWSTR dirs,
UINT fFlags
);
매개 변수
[in, out] pszPath
형식: PWSTR
resolve 경로를 포함하는 null로 끝나는 유니코드 문자열입니다. 함수가 반환되면 문자열에는 해당 정규화된 경로가 포함됩니다. 이 버퍼는 최소 MAX_PATH 문자여야 합니다.
[in, optional] dirs
형식: PZPCWSTR
pszPath에서 경로를 확인할 수 없는 경우 먼저 검색할 선택적 null 종료 디렉터리 배열에 대한 포인터입니다. 이 값은 NULL일 수 있습니다.
fFlags
형식: UINT
함수 작동 방식을 지정하는 플래그입니다.
PRF_VERIFYEXISTS
파일의 존재가 확인되면 TRUE 를 반환합니다. 그렇지 않으면 FALSE입니다.
PRF_TRYPROGRAMEXTENSIONS
.pif, .com, .bat, .cmd, .lnk 및 .exe 확장이 추가된 지정된 경로를 찾습니다.
PRF_FIRSTDIRDEF
dirs로 지정된 디렉터리 또는 디렉터리에서 먼저 찾습니다.
PRF_DONTFINDLNK
.lnk 파일을 무시합니다.
PRF_REQUIREABSOLUTE
절대(전체) 경로가 필요합니다.
반환 값
형식: int
PRF_VERIFYEXISTS 설정되지 않은 경우 TRUE를 반환합니다. 해당 플래그가 설정되면 파일이 있는 것으로 확인되면 함수가 TRUE 를 반환하고, 그렇지 않으면 FALSE 를 반환합니다. 또한 GetLastError를 호출하여 검색할 수 있는 ERROR_FILE_NOT_FOUND 오류 코드를 설정합니다.
설명
FALSE 반환 값이 반드시 파일이 존재하지 않는다는 의미는 아닙니다. 함수가 제공된 정보에서 파일을 찾을 수 없다는 의미일 수 있습니다.
PathResolve가 pszPath에 지정된 경로를 resolve 수 없는 경우 pszPath 및 dirs를 매개 변수로 사용하여 PathFindOnPath를 호출합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | shlobj_core.h(Shlobj.h 포함) |
| 라이브러리 | Shell32.lib |
| DLL | Shell32.dll(버전 5.0 이상) |
| API 세트 | ext-ms-win-shell-shell32-l1-2-2(Windows 10 버전 10.0.14393에 도입됨) |