Função SHCreateShellFolderView (shlobj_core.h)

  • Artigo

Cria uma nova instância do objeto de exibição de pasta do Shell padrão (DefView).

Sintaxe

SHSTDAPI SHCreateShellFolderView(
  [in]  const SFV_CREATE *pcsfv,
  [out] IShellView       **ppsv
);

Parâmetros

[in] pcsfv

Tipo: const SFV_CREATE*

Ponteiro para uma estrutura SFV_CREATE que descreve as particularidades usadas na criação dessa instância do objeto de exibição de pasta shell.

[out] ppsv

Tipo: IShellView**

Quando essa função retorna com êxito, contém um ponteiro de interface para o novo objeto IShellView . Em caso de falha, esse valor é NULL.

Retornar valor

Tipo: HRESULT

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

SHCreateShellFolderView é recomendado sobre SHCreateShellFolderViewEx devido à maior flexibilidade de seus elementos para participar de vários cenários, fornecer novas funcionalidades para a exibição e interagir com outros objetos.

Ao lidar com várias instâncias do IShellView, convém verificar qual é o objeto de exibição de pasta padrão do Shell. Para fazer isso, chame QueryInterface no objeto usando o IID do IID_CDefView. Essa chamada é bem-sucedida somente quando feita no objeto de exibição de pasta do Shell padrão.

As fontes de dados que usam o objeto de exibição de pasta shell padrão devem implementar estas interfaces:

Opcionalmente, eles também podem implementar IPersistFolder3.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shlobj_core.h (inclua Shlobj.h)
Biblioteca Shell32.lib
DLL Shell32.dll (versão 5.0 ou posterior)
Conjunto de APIs ext-ms-win-shell32-l1-2-2 (introduzido no Windows 10, versão 10.0.14393)

Confira também

SFV_CREATE

SHCreateShellFolderViewEx