Compartir a través de

Función SHSetDefaultProperties (shobjidl.h)

  • Artículo

Aplica el conjunto predeterminado de propiedades en un elemento de Shell.

Sintaxis

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

Parámetros

[in, optional] hwnd

Tipo: HWND

Identificador de la ventana primaria del elemento, que recibe notificaciones de error. Este valor puede ser NULL.

[in] psi

Tipo: IShellItem*

Puntero al objeto IShellItem que representa el elemento.

dwFileOpFlags

Tipo: DWORD

Marcas que personalizan la operación. Consulte IFileOperation::SetOperationFlags para obtener valores de marca.

[in, optional] pfops

Tipo: IFileOperationProgressSink*

Puntero a un objeto IFileOperationProgressSink utilizado para seguir el progreso de la operación. Consulte IFileOperation::Advise para obtener más información. Este valor puede ser 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

La lista de propiedades para establecer un valor predeterminado procede de la entrada del Registro SetDefaultsFor en progID para la asociación de archivo del elemento. La lista tiene el prefijo "prop:" y contiene los nombres canónicos de las propiedades para establecer el valor predeterminado, por ejemplo, "prop:System.Author;System.Document.DateCreated". Las propiedades posibles de esta lista son System.Author, System.Document.DateCreated y System.Photo.DateTaken. Si la entrada SetDefaultsFor no existe en progID, esta función usa el valor predeterminado que se encuentra en la entrada SetDefaultsFor de HKEY_CLASSES_ROOT\*.

Requisitos

   
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shobjidl.h
Library Shell32.lib
Archivo DLL Shell32.dll