IShellLibrary ::SaveInKnownFolder, méthode (shobjidl_core.h)

Article
03/02/2024

Enregistre la bibliothèque dans un nouveau fichier dans un dossier connu spécifié.

Syntaxe

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

Paramètres

[in] kfidToSaveIn

Type : REFKNOWNFOLDERID

ID du dossier connu dans lequel enregistrer l’objet IShellLibrary .

Pour plus d’informations, consultez KNOWNFOLDERID.

[in] pszLibraryName

Type : LPCWSTR

Nom de fichier sous lequel enregistrer la bibliothèque. Le nom de fichier ne doit pas inclure l’extension de nom de fichier ; l’extension de nom de fichier est ajoutée automatiquement.

[in] lsf

Type : LIBRARYSAVEFLAGS

Valeur LIBRARYSAVEFLAGS qui spécifie comment gérer une collision de nom de bibliothèque.

[out] ppsiSavedTo

Type : IShellItem**

Objet IShellItem qui représente le fichier de description de la bibliothèque dans lequel la bibliothèque a été enregistrée.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

IShellLibrary ::Save et SHSaveLibraryInFolderPath créent un fichier de bibliothèque et enregistrent le fichier sur le disque.

Pour enregistrer les modifications apportées à une bibliothèque qui a un fichier de bibliothèque existant, appelez IShellLibrary ::Commit.

Si la bibliothèque est enregistrée dans le dossier Bibliothèques connues (FOLDERID_Libraries), l’emplacement de la bibliothèque est automatiquement ajouté à l’index système.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shobjidl_core.h (incluez Shobjidl.h)