Metodo IShellLibrary::GetFolders (shobjidl_core.h)

Articolo
08/26/2023

Ottiene il set di cartelle figlio contenute nella libreria.

Sintassi

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

Parametri

[in] lff

Tipo: LIBRARYFOLDERFILTER

Uno dei valori LIBRARYFOLDERFILTER seguenti che determina le cartelle da ottenere. Questi flag non possono essere combinati.

LFF_FORCEFILESYSTEM (1)

Ottiene solo le cartelle del file system. Le cartelle del file system sono cartelle con il set di attributi SFGAO_FILESYSTEM.

LFF_STORAGEITEMS (2)

Ottiene tutte le cartelle che possono essere associate agli oggetti IStorage . Queste cartelle sono cartelle con set di attributi SFGAO_STORAGE o SFGAO_FILESYSTEM .

LFF_ALLITEMS (3)

Ottiene tutte le cartelle nella raccolta.

[in] riid

Tipo: REFIID

Riferimento all'IID dell'interfaccia da ottenere in ppv. Questo valore è in genere IID_IShellItemArray, ma può anche essere IID_IObjectCollection, IID_IObjectArray o l'IID di qualsiasi altra interfaccia implementata da CShellItemArray.

[out] ppv

Tipo: void**

Puntatore all'interfaccia richiesta in riid. Se la chiamata ha esito negativo, questo valore è NULL.

Valore restituito

Tipo: HRESULT

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	La chiamata ha avuto esito positivo e le cartelle specificate sono state restituite in ppv.
S_FALSE	La chiamata ha avuto esito positivo ma non tutte le cartelle specificate sono state restituite in ppv.
E_	Questo metodo può restituire altri valori di errore.

Commenti

Questo metodo ottiene un elenco ordinato di cartelle. Per impostazione predefinita, questo metodo restituisce solo i percorsi di archiviazione.

Per ottenere risultati ottimali, usare la macro IID_PPV_ARGS , definita in Objbase.h, per i parametri riid e ppv . Questa macro fornisce l'IID corretto in base all'interfaccia a cui punta il valore in ppv, che elimina la possibilità di un errore di codifica.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shobjidl_core.h (include Shobjidl.h)