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

Artículo
03/02/2024

Obtiene el conjunto de carpetas secundarias contenidas en la biblioteca.

Sintaxis

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

Parámetros

[in] lff

Tipo: LIBRARYFOLDERFILTER

Uno de los siguientes valores LIBRARYFOLDERFILTER que determina las carpetas que se van a obtener. Estas marcas no se pueden combinar.

LFF_FORCEFILESYSTEM (1)

Obtenga solo carpetas del sistema de archivos. Las carpetas del sistema de archivos son carpetas que tienen establecido el atributo SFGAO_FILESYSTEM .

LFF_STORAGEITEMS (2)

Obtenga todas las carpetas que se pueden enlazar a objetos IStorage . Estas carpetas son carpetas que tienen el SFGAO_STORAGE o SFGAO_FILESYSTEM conjunto de atributos.

LFF_ALLITEMS (3)

Obtenga todas las carpetas de la biblioteca.

[in] riid

Tipo: REFIID

Referencia al IID de la interfaz para obtener en ppv. Este valor suele ser IID_IShellItemArray, pero también puede ser IID_IObjectCollection, IID_IObjectArray o IID de cualquier otra interfaz implementada por CShellItemArray.

[out] ppv

Tipo: void**

Puntero a la interfaz solicitada en riid. Si se produce un error en esta llamada, este valor es NULL.

Valor devuelto

Tipo: HRESULT

Este método puede devolver uno de estos valores.

Código devuelto	Descripción
S_OK	La llamada se realizó correctamente y las carpetas especificadas se devolvieron en ppv.
S_FALSE	La llamada se realizó correctamente, pero no todas las carpetas especificadas se devolvieron en ppv.
E_	Este método puede devolver otros valores de error.

Comentarios

Este método obtiene una lista ordenada de carpetas. De forma predeterminada, este método solo devuelve ubicaciones de almacenamiento.

Para obtener los mejores resultados, use la macro IID_PPV_ARGS , definida en Objbase.h, para los parámetros riid y ppv . Esta macro proporciona el IID correcto basado en la interfaz a la que apunta el valor en ppv, lo que elimina la posibilidad de un error de codificación.

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