Поделиться через


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

Файлы описания библиотек — это XML-файлы, определяющие библиотеки. Библиотеки объединяют элементы из локальных и удаленных расположений хранилища в одно представление в проводнике Windows. Файлы описания библиотеки следуют схеме описания библиотеки и сохраняются как файлы *.library-ms.

В этом разделе содержатся следующие разделы:

Обзор схемы описания библиотеки

Библиотеки содержат файлы, хранящиеся в одном или нескольких расположениях хранилища. Библиотеки на самом деле не хранят эти файлы; Вместо этого они отслеживают папки, содержащие файлы, и позволяют пользователям получать доступ и упорядочивать файлы разными способами. Например, у пользователя могут быть музыкальные файлы в нескольких папках на локальном жестком диске, а также на внешнем жестком диске. Используя библиотеку музыки, пользователь может получить доступ ко всем этим файлам одновременно и отсортировать их по имени художника или названию альбома в виде одной группы.

Схема описания библиотеки состоит из трех основных частей, описанных в следующей таблице:

Часть Описание
Общие сведения о библиотеке Сведения о библиотеке, например имя, владелец, версия, значок, который проводник Windows может использовать при отображении библиотеки пользователю.
Свойства библиотеки Одно или несколько свойств, описывающих библиотеку. Эти настраиваемые свойства относятся к библиотеке.
Расположения библиотеки Один или несколько соединителей поиска, определяющих расположения хранилища для включения в библиотеку. Каждый из этих расположений также может иметь уникальный набор свойств.

 

Файлы библиотеки в Windows 7 хранятся в известной папке FOLDERID_Libraries. По умолчанию папка FOLDERID_Libraries находится в %USERPROFILE%\AppData\Roaming\Microsoft\Windows\Libraries.

Управление версиями пространства имен

Версии формата файла описания библиотеки (*.library-ms) отслеживаются путем изменения пространства имен. Для Windows 7 формат файла имеет следующее пространство имен по умолчанию: https://schemas.microsoft.com/windows/2009/library.

Однако версии содержимого библиотеки отслеживаются с помощью элемента <версии> в определенном файле описания библиотеки.

Пример файла описания библиотеки

Ниже приведен пример файла описания библиотеки, который определяет библиотеку для файлов документов.

<?xml version="1.0" encoding="UTF-8"?>
<libraryDescription xmlns="http://schemas.microsoft.com/windows/2009/library">
    <name>@shell32.dll,-34575</name>
    <ownerSID>S-1-5-21-379071477-2495173225-776587366-1000</ownerSID>
    <version>1</version>
    <isLibraryPinned>true</isLibraryPinned>
    <iconReference>imageres.dll,-1002</iconReference>
    <templateInfo>
        <folderType>{7d49d726-3c21-4f05-99aa-fdc2c9474656}</folderType>
    </templateInfo>
    <searchConnectorDescriptionList>
        <searchConnectorDescription publisher="Microsoft" product="Windows">
            <description>@shell32.dll,-34577</description>
            <isDefaultSaveLocation>true</isDefaultSaveLocation>
            <simpleLocation>
                <url>knownfolder:{FDD39AD0-238F-46AF-ADB4-6C85480369C7}</url>
                <serialized>MBAAAEAFCAAA...MFNVAAAAAA</serialized>
            </simpleLocation>
        </searchConnectorDescription>
        <searchConnectorDescription publisher="Microsoft" product="Windows">
            <description>@shell32.dll,-34579</description>
            <isDefaultNonOwnerSaveLocation>true</isDefaultNonOwnerSaveLocation>
            <simpleLocation>
                <url>knownfolder:{ED4824AF-DCE4-45A8-81E2-FC7965083634}</url>
                <serialized>MBAAAEAFCAAA...HJIfK9AAAAAA</serialized>
            </simpleLocation>
        </searchConnectorDescription>
    </searchConnectorDescriptionList>
</libraryDescription>

элемент folderType (схема библиотеки)

элемент iconReference (схема библиотеки)

элемент IsLibraryPinned (схема библиотеки)

элемент libraryDescription (схема библиотеки)

элемент имени (схема библиотеки)

элемент ownerSID (схема библиотеки)

элемент свойства (схема библиотеки)

элемента propertyStore (схема библиотеки)

элемент searchConnectorDescription (схема библиотеки)

элемент searchConnectorDescriptionList (схема библиотеки)

элемента templateInfo (схема библиотеки)

элемент версии (схема библиотеки)

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