Интерфейс IShellLibrary (shobjidl_core.h)

Предоставляет методы для создания библиотек и управления ими.

Наследование

Интерфейс IShellLibrary наследуется от интерфейса IUnknown . IShellLibrary также имеет следующие типы членов:

Методы

Интерфейс IShellLibrary содержит следующие методы.

IShellLibrary::AddFolder Добавляет папку в библиотеку.
IShellLibrary::Commit Фиксирует обновления библиотеки в существующем файле описания библиотеки.
IShellLibrary::GetDefaultSaveFolder Извлекает целевую папку по умолчанию, которую библиотека использует для операций сохранения.
IShellLibrary::GetFolders Возвращает набор дочерних папок, содержащихся в библиотеке.
IShellLibrary::GetFolderType Возвращает тип папки библиотеки.
IShellLibrary::GetIcon Возвращает значок по умолчанию для библиотеки.
IShellLibrary::GetOptions Возвращает параметры библиотеки.
IShellLibrary::LoadLibraryFromItem Загружает библиотеку из указанного файла определения библиотеки.
IShellLibrary::LoadLibraryFromKnownFolder Загружает библиотеку, на которую ссылается ИЗВЕСТНЫЙFOLDERID.
IShellLibrary::RemoveFolder Удаляет папку из библиотеки.
IShellLibrary::ResolveFolder Разрешает целевое расположение папки библиотеки, даже если папка была перемещена или переименована.
IShellLibrary::Save Сохраняет библиотеку в новый файл описания библиотеки (*.library-ms).
IShellLibrary::SaveInKnownFolder Сохраняет библиотеку в новый файл в указанной известной папке.
IShellLibrary::SetDefaultSaveFolder Задает целевую папку по умолчанию, которую библиотека будет использовать для операций сохранения.
IShellLibrary::SetFolderType Задает тип папки библиотеки.
IShellLibrary::SetIcon Задает значок по умолчанию для библиотеки.
IShellLibrary::SetOptions Задает параметры библиотеки.

Комментарии

Когда следует реализовать

Пользовательские реализации IShellLibrary не поддерживаются; клиентские приложения используют реализацию, предоставляемую Shell32.dll.

Когда следует использовать

Используйте IShellLibrary для создания новой библиотеки, запроса или обновления атрибутов существующей библиотеки.

Вспомогательные функции библиотеки

Shobjidl.h предоставляет следующие вспомогательные функции библиотеки.

Имя	Сводка
SHAddFolderPathToLibrary	Добавляет папку в библиотеку.
SHCreateLibrary	Создает объект IShellLibrary .
SHLoadLibraryFromItem	Создает и загружает объект IShellLibrary из указанного файла определения библиотеки.
SHLoadLibraryFromKnownFolder	Создает и загружает объект IShellLibrary для указанного ЗНАЧЕНИЯ KNOWNFOLDERID.
SHLoadLibraryFromParsingName	Создает и загружает объект IShellLibrary для указанного пути.
SHRemoveFolderPathFromLibrary	Удаляет папку из библиотеки.
SHResolveFolderPathInLibrary	Пытается разрешить целевое расположение папки библиотеки, которая была перемещена или переименована.
SHResolveLibrary	Пытается найти расположение библиотеки.
SHSaveLibraryInFolderPath	Сохраняет объект IShellLibrary на диск.
SHShowManageLibraryUI	Отображает диалоговое окно управления библиотекой, которое позволяет пользователям управлять папками библиотеки и расположением сохранения по умолчанию.

 

Перечисления библиотек

Следующие перечисления поддерживают библиотеки.

Имя	Сводка
DEFAULTSAVEFOLDERTYPE	Указывает, является ли место сохранения по умолчанию общедоступным или частным.
LIBRARYOPTIONFLAGS	Задает параметры библиотеки.
LIBRARYSAVEFLAGS	Определяет параметры для обработки конфликта имен при сохранении библиотеки.

Требования

Требование	Значение
Минимальная версия клиента	Windows 7 [только классические приложения]
Минимальная версия сервера	Windows Server 2008 R2 [только классические приложения]
Целевая платформа	Windows
Header	shobjidl_core.h (включая Shobjidl.h)

См. также раздел

Руководство по реализации расширений In-Process

Схема описания библиотеки

Библиотеки Windows