Funzione SHSetDefaultProperties (shobjidl.h)

Articolo
08/26/2023

Applica il set predefinito di proprietà in un elemento shell.

Sintassi

SHSTDAPI SHSetDefaultProperties(
  [in, optional] HWND                       hwnd,
  [in]           IShellItem                 *psi,
                 DWORD                      dwFileOpFlags,
  [in, optional] IFileOperationProgressSink *pfops
);

Parametri

[in, optional] hwnd

Tipo: HWND

Handle per la finestra padre dell'elemento, che riceve notifiche di errore. Questo valore può essere NULL.

[in] psi

Tipo: IShellItem*

Puntatore all'oggetto IShellItem che rappresenta l'elemento.

dwFileOpFlags

Tipo: DWORD

Flag che personalizzano l'operazione. Per i valori di flag, vedere IFileOperation::SetOperationFlags .

[in, optional] pfops

Tipo: IFileOperationProgressSink*

Puntatore a un oggetto IFileOperationProgressSink utilizzato per seguire lo stato dell'operazione. Per informazioni dettagliate, vedere IFileOperation::Advise . Questo valore può essere NULL.

Valore restituito

Tipo: HRESULT

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

Commenti

L'elenco di proprietà per impostare un valore predefinito proviene dalla voce del Registro di sistema SetDefaultsFor sotto ProgID per l'associazione di file dell'elemento. L'elenco è preceduto da "prop:" e contiene i nomi canonici delle proprietà per impostare il valore predefinito, ad esempio "prop:System.Author;System.Document.DateCreated". Le possibili proprietà di questo elenco sono System.Author, System.Document.DateCreated e System.Photo.DateTaken. Se la voce SetDefaultsFor non esiste in ProgID, questa funzione usa il valore predefinito trovato nella voce SetDefaultsFor di HKEY_CLASSES_ROOT\*.

Requisiti


Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shobjidl.h
Libreria	Shell32.lib
DLL	Shell32.dll

Condividi tramite