Interface IShellLibrary (shobjidl_core.h)

Article
03/02/2024

Expose les méthodes de création et de gestion des bibliothèques.

Héritage

L’interface IShellLibrary hérite de l’interface IUnknown . IShellLibrary a également les types de membres suivants :

Méthodes

L’interface IShellLibrary utilise ces méthodes.


IShellLibrary ::AddFolder Ajoute un dossier à la bibliothèque.
IShellLibrary ::Commit Valide les mises à jour de bibliothèque dans un fichier de description de bibliothèque existant.
IShellLibrary ::GetDefaultSaveFolder Récupère le dossier cible par défaut que la bibliothèque utilise pour les opérations d’enregistrement.
IShellLibrary ::GetFolders Obtient l’ensemble de dossiers enfants contenus dans la bibliothèque.
IShellLibrary ::GetFolderType Obtient le type de dossier de la bibliothèque.
IShellLibrary ::GetIcon Obtient l’icône par défaut de la bibliothèque.
IShellLibrary ::GetOptions Obtient les options de la bibliothèque.
IShellLibrary ::LoadLibraryFromItem Charge la bibliothèque à partir d’un fichier de définition de bibliothèque spécifié.
IShellLibrary ::LoadLibraryFromKnownFolder Charge la bibliothèque référencée par un KNOWNFOLDERID.
IShellLibrary ::RemoveFolder Supprime un dossier de la bibliothèque.
IShellLibrary ::ResolveFolder Résout l’emplacement cible d’un dossier de bibliothèque, même si le dossier a été déplacé ou renommé.
IShellLibrary ::Save Enregistre la bibliothèque dans un nouveau fichier Description de la bibliothèque (*.library-ms).
IShellLibrary ::SaveInKnownFolder Enregistre la bibliothèque dans un nouveau fichier dans un dossier connu spécifié.
IShellLibrary ::SetDefaultSaveFolder Définit le dossier cible par défaut que la bibliothèque utilisera pour les opérations d’enregistrement.
IShellLibrary ::SetFolderType Définit le type de dossier de la bibliothèque.
IShellLibrary ::SetIcon Définit l’icône par défaut pour la bibliothèque.
IShellLibrary ::SetOptions Définit les options de bibliothèque.

Remarques

Quand implémenter

Les implémentations personnalisées d’IShellLibrary ne sont pas prises en charge ; les applications clientes utilisent l’implémentation fournie par Shell32.dll.

Quand utiliser

Utilisez IShellLibrary pour créer une bibliothèque, interroger ou mettre à jour les attributs d’une bibliothèque existante.

Fonctions d’assistance de bibliothèque

Les fonctions d’assistance de bibliothèque suivantes sont fournies par Shobjidl.h.

Nom	Résumé
SHAddFolderPathToLibrary	Ajoute un dossier à une bibliothèque.
SHCreateLibrary	Crée un objet IShellLibrary .
SHLoadLibraryFromItem	Crée et charge un objet IShellLibrary à partir d’un fichier de définition de bibliothèque spécifié.
SHLoadLibraryFromKnownFolder	Crée et charge un objet IShellLibrary pour un KNOWNFOLDERID spécifié.
SHLoadLibraryFromParsingName	Crée et charge un objet IShellLibrary pour un chemin d’accès spécifié.
SHRemoveFolderPathFromLibrary	Supprime un dossier d’une bibliothèque.
SHResolveFolderPathInLibrary	Tente de résoudre l’emplacement cible d’un dossier de bibliothèque qui a été déplacé ou renommé.
SHResolveLibrary	Tente de trouver l’emplacement d’une bibliothèque.
SHSaveLibraryInFolderPath	Enregistre un objet IShellLibrary sur le disque.
SHShowManageLibraryUI	Affiche la boîte de dialogue de gestion de la bibliothèque, qui permet aux utilisateurs de gérer les dossiers de bibliothèque et l’emplacement d’enregistrement par défaut.

Énumérations de bibliothèque

Les énumérations suivantes prennent en charge les bibliothèques.

Nom	Résumé
DEFAULTSAVEFOLDERTYPE	Spécifie si l’emplacement d’enregistrement par défaut est public ou privé.
LIBRARYOPTIONFLAGS	Spécifie les options de bibliothèque.
BIBLIOTHÈQUESAVEFLAGS	Définit des options pour gérer une collision de noms lors de l’enregistrement d’une bibliothèque.

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 (inclure Shobjidl.h)