Share via

Função SHCreateShellFolderViewEx (shlobj_core.h)

  • Artigo

Cria uma nova instância do objeto de exibição de pasta do Shell padrão. É recomendável que você use SHCreateShellFolderView em vez dessa função.

Sintaxe

SHSTDAPI SHCreateShellFolderViewEx(
  [in]  CSFV       *pcsfv,
  [out] IShellView **ppsv
);

Parâmetros

[in] pcsfv

Tipo: CSFV*

Ponteiro para uma estrutura que descreve os detalhes usados na criação dessa instância do objeto de exibição de pasta shell.

[out] ppsv

Tipo: IShellView**

O endereço de um ponteiro de interface IShellView que, quando essa função retorna com êxito, aponta para o novo objeto de exibição. 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 em SHCreateShellFolderViewEx devido à maior flexibilidade de seus elementos para participar de vários cenários, fornecer novas funcionalidades para o modo de 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 IID_CDefView. Essa chamada só é bem-sucedida no objeto de exibição de pasta do Shell padrão.

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)

Confira também

SHCreateShellFolderView