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:

• IShellFolder
• IShellFolder2
• IPersistFolder
• IPersistFolder2

Requisiti

Vedi anche

SFV_CREATE

SHCreateShellFolderViewEx