IShellFolder 인터페이스(shobjidl_core.h)

모든 Shell 네임스페이스 폴더 개체에 의해 노출되는 해당 메서드는 폴더를 관리하는 데 사용됩니다.

상속

IShellFolder 인터페이스는 IUnknown 인터페이스에서 상속됩니다. IShellFolder 에는 다음과 같은 유형의 멤버도 있습니다.

메서드

IShellFolder 인터페이스에는 이러한 메서드가 있습니다.

IShellFolder::BindToObject 처리기(일반적으로 특정 항목에 대해 IShellFolder를 구현하는 Shell 폴더 개체)를 검색합니다. 처리기의 생성을 제어하는 선택적 매개 변수는 바인딩 컨텍스트에서 전달됩니다.
IShellFolder::BindToStorage 개체의 스토리지 인터페이스에 대한 포인터를 요청합니다.
IShellFolder::CompareIDs 항목 식별자 목록이 지정된 경우 두 파일 개체 또는 폴더의 상대 순서를 결정합니다.
IShellFolder::CreateViewObject 폴더 개체에서 정보를 가져오거나 상호 작용하는 데 사용할 수 있는 개체를 요청합니다.
IShellFolder::EnumObjects 항목 식별자 열거형 개체를 만들고 해당 IEnumIDList 인터페이스를 반환하여 클라이언트가 폴더의 내용을 확인할 수 있도록 합니다. 그런 다음 해당 인터페이스에서 지원하는 메서드를 사용하여 폴더의 내용을 열거할 수 있습니다.
IShellFolder::GetAttributesOf IShellFolder가 나타내는 개체에 포함된 하나 이상의 파일 또는 폴더 개체의 특성을 가져옵니다.
IShellFolder::GetDisplayNameOf 지정된 파일 개체 또는 하위 폴더의 표시 이름을 검색합니다.
IShellFolder::GetUIObjectOf 지정된 파일 개체 또는 폴더에 대한 작업을 수행하는 데 사용할 수 있는 개체를 가져옵니다.
IShellFolder::P arseDisplayName 파일 개체 또는 폴더의 표시 이름을 항목 식별자 목록으로 변환합니다.
IShellFolder::SetNameOf 파일 개체 또는 하위 폴더의 표시 이름을 설정하여 프로세스에서 항목 식별자를 변경합니다.

설명

셸의 네임스페이스를 확장하는 개체에 대해 이 인터페이스를 구현합니다. 예를 들어 이 인터페이스를 구현하여 루트 Windows Explorer 필요로 하는 별도의 네임스페이스를 만들거나 시스템 네임스페이스의 계층 내에서 직접 새 네임스페이스를 설치합니다. 네임스페이스의 내용을 가장 잘 알고 있으므로 데이터에 액세스하는 데 필요한 모든 것을 구현해야 합니다.

셸 네임스페이스의 내용을 표시하거나 작업을 수행해야 하는 경우 이 인터페이스를 사용합니다. IShellFolder를 지원하는 개체는 일반적으로 다른 Shell 폴더 개체에 의해 만들어집니다. 폴더의 IShellFolder 인터페이스를 검색하려면 일반적으로 SHGetDesktopFolder를 호출하여 시작합니다. 이 함수는 데스크톱의 IShellFolder 인터페이스에 대한 포인터를 반환합니다. 그런 다음 해당 메서드를 사용하여 특정 네임스페이스 폴더에 대한 IShellFolder 인터페이스를 검색할 수 있습니다.

참고IShellFolder 메서드는 폴더를 기준으로 하는 PIDL만 허용합니다. IShellFolder::GetAttributesOf와 같은 일부 IShellFolder 메서드는 단일 수준 PIDL만 허용합니다. 즉, PIDL에는 단일 SHITEMID 구조체와 종결 NULL만 포함되어야 합니다. IEnumIDList를 사용하여 폴더의 내용을 열거하면 이 양식의 PIDL을 받게 됩니다. IShellFolder::CompareIDs와 같은 다른 메서드는 다단계 PIDL을 허용합니다. 이러한 PIDL은 여러 SHITEMID 구조를 가질 수 있으며 부모 폴더 아래에 있는 하나 이상의 개체를 식별할 수 있습니다. 참조를 확인하여 특정 메서드에서 어떤 유형의 PIDL을 수락할 수 있는지 확인합니다.

 

예

IShellFolder의 구현 예제는 Explorer 데이터 공급자 샘플 샘플에서 확인할 수 있습니다. 다양한 IShellFolder 메서드의 사용은 파일 작업 샘플을 비롯한 여러 샘플에서 찾을 수 있습니다.

요구 사항

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