Compartir a través de

Función SHAddDefaultPropertiesByExt (shobjidl.h)

  • Artículo

Agrega propiedades predeterminadas al almacén de propiedades como registrado para la extensión de archivo especificada.

Sintaxis

SHSTDAPI SHAddDefaultPropertiesByExt(
  [in] PCWSTR         pszExt,
  [in] IPropertyStore *pPropStore
);

Parámetros

[in] pszExt

Tipo: PCWSTR

Puntero a una cadena Unicode terminada en null que especifica la extensión.

[in] pPropStore

Tipo: IPropertyStore*

Puntero a la interfaz IPropertyStore que define las propiedades predeterminadas que se van a agregar.

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 usadas para establecer un valor predeterminado procede del SetDefaultsFor valor del Registro de ProgID para la asociación de archivo de la extensión de archivo especificada. La lista tiene el prefijo "prop:" y contiene los nombres canónicos de las propiedades para establecer el valor predeterminado, como: "prop:System.Author;System.Document.DateCreated". Las propiedades posibles para esta lista son System.Author, System.Document.DateCreated y System.Photo.DateTaken. Si el SetDefaultsFor valor no existe en progID, esta función usa el valor predeterminado encontrado en el SetDefaultsFor valor de HKEY_CLASSES_ROOT*.

System.Author tiene el valor del usuario que realizó la acción. System.Document.DateCreated y System.Photo.DateTaken usan la fecha actual. Estas tres propiedades son las únicas para las que el sistema proporciona valores predeterminados especiales.

Tenga en cuenta que hay varios tipos de propiedades:

  1. Propiedades que derivan del sistema de archivos (por ejemplo, tamaño y fecha de creación)
  2. Propiedades que derivan del archivo (por ejemplo, dimensiones y número de páginas)
  3. Propiedades que se colocan en el archivo (por ejemplo, autor y etiquetas)
Al crear un archivo, solo se proporcionan los tipos uno y dos mediante la creación del archivo. Pero un programa debe establecer explícitamente las propiedades de tipo tres. El sistema proporciona SHAddDefaultPropertiesByExt para proporcionar valores para hasta tres propiedades específicas de tipo tres. A veces, el Explorador de Windows usa esta API al guardar un archivo por primera vez o al crear un nuevo archivo después de seleccionar la opción de menú Nuevo en un menú contextual.

Requisitos

Requisito Value
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
Archivo DLL Shell32.dll