Interface IShellLibrary (shobjidl_core.h)

Artigo
03/02/2024

Expõe métodos para criar e gerenciar bibliotecas.

Herança

A interface IShellLibrary herda da interface IUnknown . O IShellLibrary também tem estes tipos de membros:

Métodos

A interface IShellLibrary tem esses métodos.


IShellLibrary::AddFolder Adiciona uma pasta à biblioteca.
IShellLibrary::Commit Confirma atualizações de biblioteca para um arquivo de Descrição da Biblioteca existente.
IShellLibrary::GetDefaultSaveFolder Recupera a pasta de destino padrão que a biblioteca usa para operações de salvamento.
IShellLibrary::GetFolders Obtém o conjunto de pastas filho contidas na biblioteca.
IShellLibrary::GetFolderType Obtém o tipo de pasta da biblioteca.
IShellLibrary::GetIcon Obtém o ícone padrão da biblioteca.
IShellLibrary::GetOptions Obtém as opções da biblioteca.
IShellLibrary::LoadLibraryFromItem Carrega a biblioteca de um arquivo de definição de biblioteca especificado.
IShellLibrary::LoadLibraryFromKnownFolder Carrega a biblioteca referenciada por um KNOWNFOLDERID.
IShellLibrary::RemoveFolder Remove uma pasta da biblioteca.
IShellLibrary::ResolveFolder Resolve o local de destino de uma pasta de biblioteca, mesmo que a pasta tenha sido movida ou renomeada.
IShellLibrary::Save Salva a biblioteca em um novo arquivo de Descrição da Biblioteca (*.library-ms).
IShellLibrary::SaveInKnownFolder Salva a biblioteca em um novo arquivo em uma pasta conhecida especificada.
IShellLibrary::SetDefaultSaveFolder Define a pasta de destino padrão que a biblioteca usará para operações de salvamento.
IShellLibrary::SetFolderType Define o tipo de pasta da biblioteca.
IShellLibrary::SetIcon Define o ícone padrão da biblioteca.
IShellLibrary::SetOptions Define as opções de biblioteca.

Comentários

Quando implementar

Não há suporte para implementações personalizadas do IShellLibrary ; os aplicativos cliente usam a implementação fornecida pelo Shell32.dll.

Quando usar

Use IShellLibrary para criar uma nova biblioteca, consultar ou atualizar os atributos de uma biblioteca existente.

Funções auxiliares de biblioteca

As funções auxiliares da biblioteca a seguir são fornecidas por Shobjidl.h.

Nome	Resumo
SHAddFolderPathToLibrary	Adiciona uma pasta a uma biblioteca.
SHCreateLibrary	Cria um objeto IShellLibrary .
SHLoadLibraryFromItem	Cria e carrega um objeto IShellLibrary de um arquivo de definição de biblioteca especificado.
SHLoadLibraryFromKnownFolder	Cria e carrega um objeto IShellLibrary para um KNOWNFOLDERID especificado.
SHLoadLibraryFromParsingName	Cria e carrega um objeto IShellLibrary para um caminho especificado.
SHRemoveFolderPathFromLibrary	Remove uma pasta de uma biblioteca.
SHResolveFolderPathInLibrary	Tenta resolve o local de destino de uma pasta de biblioteca que foi movida ou renomeada.
SHResolveLibrary	Tenta localizar o local de uma biblioteca.
SHSaveLibraryInFolderPath	Salva um objeto IShellLibrary em disco.
SHShowManageLibraryUI	Mostra a caixa de diálogo de gerenciamento de biblioteca, que permite que os usuários gerenciem as pastas da biblioteca e o local de salvamento padrão.

Enumerações de biblioteca

As enumerações a seguir dão suporte a bibliotecas.

Nome	Resumo
DEFAULTSAVEFOLDERTYPE	Especifica se o local de salvamento padrão é público ou privado.
LIBRARYOPTIONFLAGS	Especifica as opções de biblioteca.
LIBRARYSAVEFLAGS	Define opções para lidar com uma colisão de nome ao salvar uma biblioteca.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shobjidl_core.h (inclua Shobjidl.h)