Função SHCreateShellFolderView (shlobj_core.h)
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) |