Partilhar via


Esquema de descrição da biblioteca

Os arquivos de descrição de bibliotecas são arquivos XML que definem bibliotecas. As bibliotecas agregam itens de locais de armazenamento local e remoto em uma única exibição no Windows Explorer. Os arquivos de descrição da biblioteca seguem o esquema Descrição da biblioteca e são salvos como arquivos *.library-ms.

Este tópico contém as seguintes seções:

Visão geral do esquema de descrição da biblioteca

As bibliotecas contêm arquivos armazenados em um ou mais locais de armazenamento. Na verdade, as bibliotecas não armazenam esses arquivos; Em vez disso, eles monitoram as pastas que contêm os arquivos e permitem que os usuários acessem e organizem os arquivos de maneiras diferentes. Por exemplo, um usuário pode ter arquivos de música em várias pastas em um disco rígido local e também em um disco rígido externo. Usando o Music Library, o usuário pode acessar todos esses arquivos ao mesmo tempo e classificá-los todos por nome do artista ou título do álbum como um único grupo.

O esquema Descrição da Biblioteca consiste em três partes principais, descritas na tabela a seguir:

Peça Descrição
Informações gerais sobre a biblioteca Informações sobre a biblioteca, como nome, proprietário, versão, ícone, que o Windows Explorer pode usar quando exibe a biblioteca para um usuário.
Propriedades da biblioteca Uma ou mais propriedades que descrevem a biblioteca. Essas propriedades personalizadas são específicas da biblioteca.
Localizações das bibliotecas Um ou mais conectores de pesquisa que identificam locais de armazenamento a serem incluídos na biblioteca. Cada um desses locais também pode ter um conjunto exclusivo de propriedades.

 

Os arquivos de biblioteca no Windows 7 são armazenados na pasta conhecida, FOLDERID_Libraries. Por padrão, a pasta FOLDERID_Libraries está localizada em %USERPROFILE%\AppData\Roaming\Microsoft\Windows\Libraries.

Controle de versão de namespace

As versões do formato de arquivo Descrição da Biblioteca (*.library-ms) são controladas alterando o namespace. Para o Windows 7, o formato de arquivo tem o seguinte namespace padrão: https://schemas.microsoft.com/windows/2009/library.

As versões do conteúdo da biblioteca, no entanto, são controladas usando o elemento <version> em um arquivo específico de Descrição da Biblioteca.

Exemplo de um arquivo de descrição de biblioteca

Segue-se um exemplo de um ficheiro de Descrição de Biblioteca que define uma biblioteca para ficheiros de documentos.

<?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>

elemento folderType (esquema de biblioteca)

elemento iconReference (esquema de biblioteca)

elemento isLibraryPinned (esquema de biblioteca)

elemento libraryDescription (esquema de biblioteca)

elemento de nome (esquema de biblioteca)

elemento ownerSID (esquema de biblioteca)

propriedade Element (Library Schema)

elemento propertyStore (esquema de biblioteca)

elemento searchConnectorDescription (esquema de biblioteca)

elemento searchConnectorDescriptionList (esquema de biblioteca)

elemento templateInfo (esquema de biblioteca)

elemento versão (esquema de biblioteca)

Esquema de descrição do conector de pesquisa