IFileDialog::SetFolder 메서드(shobjidl_core.h)

이전 사용자 작업에 관계없이 대화 상자가 열릴 때 항상 선택되는 폴더를 설정합니다.

구문

HRESULT SetFolder(
  [in] IShellItem *psi
);

매개 변수

[in] psi

형식: IShellItem*

폴더를 나타내는 인터페이스에 대한 포인터입니다.

반환 값

형식: HRESULT

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

설명

이 폴더는 "가장 최근에 사용한" 폴더를 재정의합니다. 대화 상자가 표시되는 동안 이 메서드가 호출되면 대화 상자가 지정된 폴더로 이동합니다.

일반적으로 이 메서드를 사용하지 않는 것이 좋습니다. 대화 상자를 표시하기 전에 SetFolder 를 호출하는 경우 사용자가 저장하거나 연 가장 최근의 위치는 표시되지 않습니다. 이 동작에 대한 매우 구체적인 이유가 없는 한 좋은 사용자 환경이나 예상 사용자 환경이 아니므로 피해야 합니다. 거의 모든 인스턴스에서 IFileDialog::SetDefaultFolder 가 더 나은 방법입니다.

Windows 7부터 psi 를 통해 지정된 폴더의 경로가 알려진 폴더의 기본 경로인 경우 알려진 폴더의 현재 경로가 대화 상자에서 사용됩니다. 해당 경로는 psi에 지정된 경로와 같지 않을 수 있습니다. instance 대해 알려진 폴더가 리디렉션된 경우 입니다. 알려진 폴더가 라이브러리(가상 폴더 문서, 음악, 사진 및 비디오)인 경우 라이브러리의 경로가 대화 상자에 사용됩니다. 지정된 라이브러리가 숨겨지면(기본적으로 Windows 8.1) 라이브러리의 기본 저장 위치가 대화 상자에서 사용됩니다(예: 문서 라이브러리의 Microsoft OneDrive 문서 폴더). 이러한 매핑으로 인해 대화 상자에서 사용되는 폴더 위치가 이 메서드를 호출할 때 지정한 것과 정확히 일치하지 않을 수 있습니다.

요구 사항

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