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:

• Ishellfolder
• IShellFolder2
• IPersistFolder
• IPersistFolder2

Requisitos

Confira também

SFV_CREATE

SHCreateShellFolderViewEx