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

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

구문

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

[in] rfid

형식: REFKNOWNFOLDERID

KNOWNFOLDERID에 대한 참조입니다.

[out] ppkf

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

형식: HRESULT

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

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

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

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