Interface IShellFolder (shobjidl_core.h)

Exposées par tous les objets de dossier d’espace de noms Shell, ses méthodes sont utilisées pour gérer les dossiers.

Héritage

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

Méthodes

L’interface IShellFolder a ces méthodes.

IShellFolder ::BindToObject Récupère un gestionnaire, généralement l’objet de dossier Shell qui implémente IShellFolder pour un élément particulier. Les paramètres facultatifs qui contrôlent la construction du gestionnaire sont passés dans le contexte de liaison.
IShellFolder ::BindToStorage Demande un pointeur vers l’interface de stockage d’un objet.
IShellFolder ::CompareIDs Détermine l’ordre relatif de deux objets ou dossiers de fichiers, en fonction de leurs listes d’identificateurs d’élément.
IShellFolder ::CreateViewObject Demande un objet qui peut être utilisé pour obtenir des informations à partir d’un objet folder ou interagir avec celui-ci.
IShellFolder ::EnumObjects Permet à un client de déterminer le contenu d’un dossier en créant un objet d’énumération d’identificateur d’élément et en retournant son interface IEnumIDList. Les méthodes prises en charge par cette interface peuvent ensuite être utilisées pour énumérer le contenu du dossier.
IShellFolder ::GetAttributesOf Obtient les attributs d’un ou plusieurs objets fichier ou dossier contenus dans l’objet représenté par IShellFolder.
IShellFolder ::GetDisplayNameOf Récupère le nom d’affichage de l’objet de fichier ou du sous-dossier spécifié.
IShellFolder ::GetUIObjectOf Obtient un objet qui peut être utilisé pour effectuer des actions sur les objets de fichier ou dossiers spécifiés.
IShellFolder ::P arseDisplayName Convertit le nom complet d’un objet fichier ou d’un dossier en liste d’identificateurs d’élément.
IShellFolder ::SetNameOf Définit le nom d’affichage d’un objet ou d’un sous-dossier de fichier, en modifiant l’identificateur d’élément dans le processus.

Remarques

Implémentez cette interface pour les objets qui étendent l’espace de noms de l’interpréteur de commandes. Par exemple, implémentez cette interface pour créer un espace de noms distinct qui nécessite un Explorer Windows rooté ou pour installer un nouvel espace de noms directement dans la hiérarchie de l’espace de noms système. Vous êtes le plus familiarisé avec le contenu de votre espace de noms. Vous êtes donc responsable de l’implémentation de tout ce qui est nécessaire pour accéder à vos données.

Utilisez cette interface lorsque vous devez afficher ou effectuer une opération sur le contenu de l’espace de noms de l’interpréteur de commandes. Les objets qui prennent en charge IShellFolder sont généralement créés par d’autres objets de dossier Shell. Pour récupérer l’interface IShellFolder d’un dossier, vous commencez généralement par appeler SHGetDesktopFolder. Cette fonction retourne un pointeur vers l’interface IShellFolder du bureau. Vous pouvez ensuite utiliser ses méthodes pour récupérer une interface IShellFolder pour un dossier d’espace de noms particulier.

Remarque Les méthodes IShellFolder acceptent uniquement les PIDL relatifs au dossier. Certaines méthodes IShellFolder , telles que IShellFolder ::GetAttributesOf, acceptent uniquement les PIDL à un seul niveau. En d’autres termes, le PIDL ne doit contenir qu’une seule structure SHITEMID , plus la valeur NULL de fin. Lorsque vous énumérez le contenu d’un dossier avec IEnumIDList, vous recevez des fichiers PIDL de ce formulaire. D’autres méthodes, telles que IShellFolder ::CompareIDs, acceptent les PIDL à plusieurs niveaux. Ces PIDL peuvent avoir plusieurs structures SHITEMID et identifier des objets à un ou plusieurs niveaux sous le dossier parent. Vérifiez la référence pour vous assurer que le type de PIDL peut être accepté par une méthode particulière.

 

Exemples

Vous trouverez un exemple d’implémentation d’IShellFolder dans l’exemple de fournisseur de données Explorer. L’utilisation de différentes méthodes IShellFolder se trouve dans plusieurs exemples, notamment l’exemple d’opérations de fichier.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shobjidl_core.h