Funzione SHCreateShellFolderView (shlobj_core.h)

Articolo
03/05/2024

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

Condividi tramite