IShellLibrary 인터페이스(shobjidl_core.h)

아티클
03/02/2024

라이브러리를 만들고 관리하기 위한 메서드를 노출합니다.

상속

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

메서드

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


IShellLibrary::AddFolder 라이브러리에 폴더를 추가합니다.
IShellLibrary::Commit 라이브러리 업데이트를 기존 라이브러리 설명 파일에 커밋합니다.
IShellLibrary::GetDefaultSaveFolder 라이브러리가 저장 작업에 사용하는 기본 대상 폴더를 검색합니다.
IShellLibrary::GetFolders 라이브러리에 포함된 자식 폴더 집합을 가져옵니다.
IShellLibrary::GetFolderType 라이브러리의 폴더 형식을 가져옵니다.
IShellLibrary::GetIcon 라이브러리의 기본 아이콘을 가져옵니다.
IShellLibrary::GetOptions 라이브러리의 옵션을 가져옵니다.
IShellLibrary::LoadLibraryFromItem 지정된 라이브러리 정의 파일에서 라이브러리를 로드합니다.
IShellLibrary::LoadLibraryFromKnownFolder KNOWNFOLDERID에서 참조하는 라이브러리를 로드합니다.
IShellLibrary::RemoveFolder 라이브러리에서 폴더를 제거합니다.
IShellLibrary::ResolveFolder 폴더가 이동되거나 이름이 변경된 경우에도 라이브러리 폴더의 대상 위치를 확인합니다.
IShellLibrary::Save 라이브러리를 새 라이브러리 설명(*.library-ms) 파일에 저장합니다.
IShellLibrary::SaveInKnownFolder 지정된 알려진 폴더의 새 파일에 라이브러리를 저장합니다.
IShellLibrary::SetDefaultSaveFolder 라이브러리가 저장 작업에 사용할 기본 대상 폴더를 설정합니다.
IShellLibrary::SetFolderType 라이브러리의 폴더 유형을 설정합니다.
IShellLibrary::SetIcon 라이브러리의 기본 아이콘을 설정합니다.
IShellLibrary::SetOptions 라이브러리 옵션을 설정합니다.

설명

구현 시기

IShellLibrary의 사용자 지정 구현은 지원되지 않습니다. 클라이언트 애플리케이션은 Shell32.dll 제공하는 구현을 사용합니다.

사용해야 하는 경우

IShellLibrary를 사용하여 새 라이브러리를 만들거나, 기존 라이브러리의 특성을 쿼리하거나 업데이트합니다.

라이브러리 도우미 함수

Shobjidl.h에서 제공하는 라이브러리 도우미 함수는 다음과 같습니다.

Name	요약
SHAddFolderPathToLibrary	라이브러리에 폴더를 추가합니다.
SHCreateLibrary	IShellLibrary 개체를 만듭니다.
SHLoadLibraryFromItem	지정된 라이브러리 정의 파일에서 IShellLibrary 개체를 만들고 로드합니다.
SHLoadLibraryFromKnownFolder	지정된 KNOWNFOLDERID에 대한 IShellLibrary 개체를 만들고 로드합니다.
SHLoadLibraryFromParsingName	지정된 경로에 대한 IShellLibrary 개체를 만들고 로드합니다.
SHRemoveFolderPathFromLibrary	라이브러리에서 폴더를 제거합니다.
SHResolveFolderPathInLibrary	이동되거나 이름이 변경된 라이브러리 폴더의 대상 위치를 resolve 시도합니다.
SHResolveLibrary	라이브러리의 위치를 찾으려고 시도합니다.
SHSaveLibraryInFolderPath	IShellLibrary 개체를 디스크에 저장합니다.
SHShowManageLibraryUI	사용자가 라이브러리 폴더 및 기본 저장 위치를 관리할 수 있도록 하는 라이브러리 관리 대화 상자를 표시합니다.

라이브러리 열거형

다음 열거형은 라이브러리를 지원합니다.

Name	요약
DEFAULTSAVEFOLDERTYPE	기본 저장 위치가 퍼블릭인지 프라이빗인지 지정합니다.
LIBRARYOPTIONFLAGS	라이브러리 옵션을 지정합니다.
LIBRARYSAVEFLAGS	라이브러리를 저장할 때 이름 충돌을 처리하는 옵션을 정의합니다.

요구 사항

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