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

Artículo
03/02/2024

Guarda la biblioteca en un archivo nuevo en una carpeta conocida especificada.

Sintaxis

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

Parámetros

[in] kfidToSaveIn

Tipo: REFKNOWNFOLDERID

Identificador de la carpeta conocida en la que se va a guardar el objeto IShellLibrary .

Para obtener más información, vea KNOWNFOLDERID.

[in] pszLibraryName

Tipo: LPCWSTR

Nombre de archivo en el que se va a guardar la biblioteca. El nombre de archivo no debe incluir la extensión de nombre de archivo; La extensión de nombre de archivo se agrega automáticamente.

[in] lsf

Tipo: LIBRARYSAVEFLAGS

Valor LIBRARYSAVEFLAGS que especifica cómo controlar una colisión de nombres de biblioteca.

[out] ppsiSavedTo

Tipo: IShellItem**

Objeto IShellItem que representa el archivo de descripción de la biblioteca en el que se guardó la biblioteca.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

IShellLibrary::Save y SHSaveLibraryInFolderPath crean un nuevo archivo de biblioteca y guardan el archivo en el disco.

Para guardar los cambios realizados en una biblioteca que tiene un archivo de biblioteca existente, llame a IShellLibrary::Commit.

Si la biblioteca se guarda en la carpeta Bibliotecas conocidas (FOLDERID_Libraries), la ubicación de la biblioteca se agrega automáticamente al índice del sistema.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	shobjidl_core.h (include Shobjidl.h)