Share via

IKnownFolderManager::GetFolder 메서드(shobjidl_core.h)

  • 아티클

KNOWNFOLDERID로 식별된 알려진 폴더를 나타내는 개체를 가져옵니다. 개체를 사용하면 특정 폴더 속성을 쿼리하고, 폴더의 현재 경로를 가져와서 폴더를 다른 위치로 리디렉션하고, 폴더의 경로를 ITEMIDLIST로 가져올 수 있습니다.

구문

HRESULT GetFolder(
  [in]  REFKNOWNFOLDERID rfid,
  [out] IKnownFolder     **ppkf
);

매개 변수

[in] rfid

형식: REFKNOWNFOLDERID

KNOWNFOLDERID에 대한 참조입니다.

[out] ppkf

형식: IKnownFolder**

이 메서드가 반환되면 폴더를 나타내는 IKnownFolder 개체에 대한 인터페이스 포인터가 포함됩니다.

반환 값

형식: HRESULT

성공하면 S_OK 반환하고, 그렇지 않으면 다음을 포함하여 오류 값을 반환합니다.

반환 코드 설명
E_INVALIDARG
 무엇보다도 이 값은 rfid 매개 변수가 시스템에 없는 KNOWNFOLDERID 를 참조함을 나타낼 수 있습니다. 모든 KNOWNFOLDERID 값이 모든 시스템에 있는 것은 아닙니다. IKnownFolderManager::GetFolderIds를 사용하여 현재 시스템에 대한 KNOWNFOLDERID 값 집합을 검색합니다.

설명

이 메서드를 호출하려면 호출자에게 사용자 이상의 권한이 있어야 합니다.

사용해야 하는 경우

찾고 있는 알려진 폴더를 정확히 알고 직접 액세스하려는 경우 이 메서드를 사용합니다.

요구 사항

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

추가 정보

IKnownFolderManager

알려진 폴더 샘플