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에 도입됨)

추가 정보

PathFindOnPath