Condividi tramite


Funzione SHCreateShellFolderView (shlobj_core.h)

Crea una nuova istanza dell'oggetto visualizzazione cartella shell predefinito (DefView).

Sintassi

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

Parametri

[in] pcsfv

Tipo: const SFV_CREATE*

Puntatore a una struttura SFV_CREATE che descrive i particolari utilizzati per la creazione di questa istanza dell'oggetto visualizzazione cartella shell.

[out] ppsv

Tipo: IShellView**

Quando questa funzione viene restituita correttamente, contiene un puntatore di interfaccia al nuovo oggetto IShellView . In caso di errore, questo valore è NULL.

Valore restituito

Tipo: HRESULT

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

SHCreateShellFolderView è consigliato su SHCreateShellFolderViewEx a causa della maggiore flessibilità dei relativi elementi per partecipare a vari scenari, fornire nuove funzionalità alla visualizzazione e interagire con altri oggetti.

Quando si gestiscono diverse istanze di IShellView, è possibile verificare quale sia l'oggetto visualizzazione cartella shell predefinito. A tale scopo, chiamare QueryInterface sull'oggetto usando l'IID IID_CDefView. Questa chiamata ha esito positivo solo quando viene eseguita nell'oggetto visualizzazione cartella Shell predefinito.

Le origini dati che usano l'oggetto visualizzazione cartella shell predefinita devono implementare queste interfacce:

Facoltativamente, possono implementare anche IPersistFolder3.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione shlobj_core.h (includere Shlobj.h)
Libreria Shell32.lib
DLL Shell32.dll (versione 5.0 o successiva)
Set di API ext-ms-win-shell-shell32-l1-2-2 (introdotto in Windows 10, versione 10.0.14393)

Vedi anche

SFV_CREATE

SHCreateShellFolderViewEx