库说明架构

库说明文件是定义库的 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 元素 (库架构)

name 元素 (库架构)

ownerSID 元素 (库架构)

property 元素 (库架构)

propertyStore 元素 (库架构)

searchConnectorDescription 元素 (库架构)

searchConnectorDescriptionList 元素 (库架构)

templateInfo 元素 (库架构)

version 元素 (库架构)

搜索连接器说明架构