Compartilhar via


Esquema de descrição da biblioteca

Os arquivos de descrição da biblioteca 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 de 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. 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 a Biblioteca de Música, 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 de Descrição da Biblioteca consiste em três partes principais, descritas na tabela a seguir:

Parte Descrição
Informações gerais da 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 para a biblioteca.
Locais da biblioteca 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 do namespace

As versões do formato de arquivo de 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.

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

Exemplo de um arquivo de descrição da biblioteca

Veja a seguir um exemplo de um arquivo de Descrição da Biblioteca que define uma biblioteca para arquivos de documento.

<?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 name (esquema de biblioteca)

Elemento ownerSID (esquema de biblioteca)

Elemento property (Esquema de Biblioteca)

Elemento propertyStore (Esquema de Biblioteca)

Elemento searchConnectorDescription (esquema de biblioteca)

Elemento searchConnectorDescriptionList (esquema de biblioteca)

Elemento templateInfo (Esquema de Biblioteca)

Elemento version (Esquema de Biblioteca)

Esquema de descrição do conector de pesquisa