Método IShellLibrary::SaveInKnownFolder (shobjidl_core.h)

Salva a biblioteca em um novo arquivo em uma pasta conhecida especificada.

Sintaxe

HRESULT SaveInKnownFolder(
  [in]  REFKNOWNFOLDERID kfidToSaveIn,
  [in]  LPCWSTR          pszLibraryName,
  [in]  LIBRARYSAVEFLAGS lsf,
  [out] IShellItem       **ppsiSavedTo
);

Parâmetros

[in] kfidToSaveIn

Tipo: REFKNOWNFOLDERID

A ID da pasta conhecida na qual salvar o objeto IShellLibrary .

Para obter mais informações, consulte KNOWNFOLDERID.

[in] pszLibraryName

Tipo: LPCWSTR

O nome do arquivo no qual salvar a biblioteca. O nome do arquivo não deve incluir a extensão de nome de arquivo; a extensão de nome de arquivo é adicionada automaticamente.

[in] lsf

Tipo: LIBRARYSAVEFLAGS

O valor LIBRARYSAVEFLAGS que especifica como lidar com uma colisão de nome de biblioteca.

[out] ppsiSavedTo

Tipo: IShellItem**

O objeto IShellItem que representa o arquivo de descrição da biblioteca no qual a biblioteca foi salva.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

IShellLibrary::Save e SHSaveLibraryInFolderPath criam um novo arquivo de biblioteca e salvam o arquivo em disco.

Para salvar as alterações feitas em uma biblioteca que tem um arquivo de biblioteca existente, chame IShellLibrary::Commit.

Se a biblioteca for salva na pasta conhecida Bibliotecas (FOLDERID_Libraries), o local da biblioteca será adicionado automaticamente ao índice do sistema.

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)

Confira também

Ishelllibrary

Exemplo de pastas conhecidas

Esquema de descrição da biblioteca

SHSaveLibraryInFolderPath

Bibliotecas do Windows