库说明架构

库说明文件是定义库的 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

但是,使用特定库说明文件中的 version 元素跟踪 <库内容的版本>

库说明文件示例

下面是定义文档文件的库的库说明文件的示例。

<?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 元素 (库架构)

name 元素 (库架构)

ownerSID 元素 (库架构)

property 元素 (库架构)

propertyStore 元素 (库架构)

searchConnectorDescription 元素 (库架构)

searchConnectorDescriptionList 元素 (库架构)

templateInfo 元素 (库架构)

version 元素 (库架构)

搜索连接器说明架构