IKnownFolder::SetPath 메서드(shobjidl_core.h)

알려진 폴더에 새 경로를 할당합니다.

구문

HRESULT SetPath(
  [in] DWORD   dwFlags,
  [in] LPCWSTR pszPath
);

매개 변수

[in] dwFlags

형식:DWORD

0 또는 다음 값 중 하나:

KF_FLAG_DONT_UNEXPAND

환경 문자열 없이 전체 경로를 설정합니다. 이 플래그가 설정되지 않은 경우 pszPath 의 경로 일부가 와 같은 %USERPROFILE%환경 문자열로 표시될 수 있습니다.

[in] pszPath

형식: LPCWSTR

폴더의 새 경로에 대한 포인터입니다. 길이 MAX_PATH null로 끝나는 유니코드 문자열입니다. 이 경로의 길이는 0일 수 없습니다. 이 값이 NULL이면 IKnownFolder::SetPath 는 경로를 기본값으로 설정합니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

이 메서드는 KF_CATEGORY_FIXED 또는 KF_CATEGORY_VIRTUAL 형식의 폴더에서 호출할 수 없습니다.

KF_CATEGORY_COMMON 형식의 폴더에서 이 메서드를 호출하려면 호출 애플리케이션이 관리자 권한으로 실행되어야 합니다.

이 메서드는 SHSetKnownFolderPath와 동일합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	shobjidl_core.h(Shobjidl.h 포함)
DLL	Shell32.dll

추가 정보

IKnownFolder

알려진 폴더 샘플

SHSetKnownFolderPath