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

Artigo
03/05/2024

Obtém o conjunto de pastas filho contidas na biblioteca.

Sintaxe

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

Parâmetros

[in] lff

Tipo: LIBRARYFOLDERFILTER

Um dos seguintes valores LIBRARYFOLDERFILTER que determina as pastas a serem obtidos. Esses sinalizadores não podem ser combinados.

LFF_FORCEFILESYSTEM (1)

Obter somente pastas do sistema de arquivos. As pastas do sistema de arquivos são pastas que têm o atributo SFGAO_FILESYSTEM definido.

LFF_STORAGEITEMS (2)

Obtenha todas as pastas que podem ser associadas a objetos IStorage . Essas pastas são pastas que têm o atributo SFGAO_STORAGE ou SFGAO_FILESYSTEM definido.

LFF_ALLITEMS (3)

Obtenha todas as pastas na biblioteca.

[in] riid

Tipo: REFIID

Uma referência ao IID da interface a ser obtido em ppv. Normalmente, esse valor é IID_IShellItemArray, mas também pode ser IID_IObjectCollection, IID_IObjectArray ou o IID de qualquer outra interface implementada por CShellItemArray.

[out] ppv

Tipo: void**

Um ponteiro para a interface solicitada em riid. Se essa chamada falhar, esse valor será NULL.

Retornar valor

Tipo: HRESULT

Esse método pode retornar um desses valores.

Código de retorno	Descrição
S_OK	A chamada foi bem-sucedida e as pastas especificadas foram retornadas em ppv.
S_FALSE	A chamada foi bem-sucedida, mas nem todas as pastas especificadas foram retornadas em ppv.
E_	Esse método pode retornar outros valores de erro.

Comentários

Esse método obtém uma lista ordenada de pastas. Por padrão, esse método retorna apenas locais de armazenamento.

Para obter melhores resultados, use a macro IID_PPV_ARGS , definida em Objbase.h, para os parâmetros riid e ppv . Essa macro fornece o IID correto com base na interface apontada pelo valor em ppv, o que elimina a possibilidade de um erro de codificação.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shobjidl_core.h (inclua Shobjidl.h)