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

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

구문

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

[in] dwFlags

형식:DWORD

0 또는 다음 값 중 하나:

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

[in] pszPath

형식: LPCWSTR

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

형식: HRESULT

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

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

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