Share via

Función SHCreateShellFolderView (shlobj_core.h)

  • Artículo

Crea una nueva instancia del objeto de vista de carpeta de Shell predeterminado (DefView).

Sintaxis

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

Parámetros

[in] pcsfv

Tipo: const SFV_CREATE*

Puntero a una estructura de SFV_CREATE que describe los detalles que se usan para crear esta instancia del objeto de vista de carpeta de Shell.

[out] ppsv

Tipo: IShellView**

Cuando esta función vuelve correctamente, contiene un puntero de interfaz al nuevo objeto IShellView . Si se produce un error, este valor es NULL.

Valor devuelto

Tipo: HRESULT

Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

SE recomienda SHCreateShellFolderView a través de SHCreateShellFolderViewEx debido a la mayor flexibilidad de sus elementos para participar en varios escenarios, proporcionar nueva funcionalidad a la vista e interactuar con otros objetos.

Al tratar con varias instancias de IShellView, es posible que desee comprobar cuál es el objeto de vista de carpeta de Shell predeterminado. Para ello, llame a QueryInterface en el objeto mediante el IID_CDefView IID. Esta llamada solo se realiza correctamente cuando se realiza en el objeto de vista de carpeta de Shell predeterminado.

Los orígenes de datos que usan el objeto de vista de carpeta de Shell predeterminado deben implementar estas interfaces:

Opcionalmente, también pueden implementar IPersistFolder3.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shlobj_core.h (incluya Shlobj.h)
Library Shell32.lib
Archivo DLL Shell32.dll (versión 5.0 o posterior)
Conjunto de API ext-ms-win-shell-shell32-l1-2-2 (introducido en Windows 10, versión 10.0.14393)

Consulte también

SFV_CREATE

SHCreateShellFolderViewEx