Méthode IShellLibrary ::GetFolders (shobjidl_core.h)

Article
03/04/2024

Obtient l’ensemble de dossiers enfants contenus dans la bibliothèque.

Syntaxe

HRESULT GetFolders(
  [in]  LIBRARYFOLDERFILTER lff,
  [in]  REFIID              riid,
  [out] void                **ppv
);

Paramètres

[in] lff

Type : LIBRARYFOLDERFILTER

L’une des valeurs LIBRARYFOLDERFILTER suivantes qui détermine les dossiers à obtenir. Ces indicateurs ne peuvent pas être combinés.

LFF_FORCEFILESYSTEM (1)

Obtenez uniquement des dossiers de système de fichiers. Les dossiers de système de fichiers sont des dossiers qui ont l’attribut SFGAO_FILESYSTEM défini.

LFF_STORAGEITEMS (2)

Obtenez tous les dossiers qui peuvent être liés à des objets IStorage . Ces dossiers sont des dossiers qui ont l’attribut SFGAO_STORAGE ou SFGAO_FILESYSTEM défini.

LFF_ALLITEMS (3)

Obtenez tous les dossiers de la bibliothèque.

[in] riid

Type : REFIID

Référence à l’IID de l’interface pour obtenir ppv. Cette valeur est généralement IID_IShellItemArray, mais elle peut également être IID_IObjectCollection, IID_IObjectArray ou l’IID de toute autre interface implémentée par CShellItemArray.

[out] ppv

Type : void**

Pointeur vers l’interface demandée dans riid. Si cet appel échoue, cette valeur est NULL.

Valeur retournée

Type : HRESULT

Cette méthode peut retourner l’une de ces valeurs.

Code de retour	Description
S_OK	L’appel a réussi et les dossiers spécifiés ont été retournés dans ppv.
S_FALSE	L’appel a réussi, mais tous les dossiers spécifiés n’ont pas été retournés dans ppv.
E_	Cette méthode peut retourner d’autres valeurs d’erreur.

Remarques

Cette méthode obtient une liste ordonnée de dossiers. Par défaut, cette méthode retourne uniquement les emplacements de stockage.

Pour obtenir de meilleurs résultats, utilisez la macro IID_PPV_ARGS , définie dans Objbase.h, pour les paramètres riid et ppv . Cette macro fournit l’IID correct en fonction de l’interface pointée vers la valeur dans ppv, ce qui élimine la possibilité d’une erreur de codage.

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)