Fonction SHAddDefaultPropertiesByExt (shobjidl.h)

Article
08/26/2023

Ajoute les propriétés par défaut au magasin de propriétés comme inscrites pour l’extension de fichier spécifiée.

Syntaxe

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

Paramètres

[in] pszExt

Type : PCWSTR

Pointeur vers une chaîne Unicode terminée par null qui spécifie l’extension.

[in] pPropStore

Type : IPropertyStore*

Pointeur vers l’interface IPropertyStore qui définit les propriétés par défaut à ajouter.

Valeur retournée

Type : HRESULT

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

La liste des propriétés utilisées pour définir une valeur par défaut provient de la SetDefaultsFor valeur de Registre du ProgID pour l’association de fichiers de l’extension de fichier spécifiée. La liste est précédée de «prop: » et contient les noms canoniques des propriétés pour définir la valeur par défaut, par exemple : «prop:System.Author;System.Document.DateCreated ». Les propriétés possibles de cette liste sont System.Author, System.Document.DateCreated et System.Photo.DateTaken. Si la SetDefaultsFor valeur n’existe pas sur le ProgID, cette fonction utilise la valeur par défaut trouvée sur la SetDefaultsFor valeur de HKEY_CLASSES_ROOT*.

System.Author a la valeur de l’utilisateur qui a effectué l’action. System.Document.DateCreated et System.Photo.DateTaken utilisent la date actuelle. Ces trois propriétés sont les seules pour lesquelles le système fournit des valeurs par défaut spéciales.

Notez qu’il existe plusieurs types de propriétés :

Propriétés qui dérivent du système de fichiers (telles que la taille et la date de création)
Propriétés qui dérivent du fichier (telles que les dimensions et le nombre de pages)
Propriétés placées dans le fichier (telles que l’auteur et les balises)

Lors de la création d’un fichier, les types un et deux sont fournis simplement en créant le fichier. Toutefois, les propriétés de type 3 doivent être définies explicitement par un programme. Le système fournit SHAddDefaultPropertiesByExt pour fournir des valeurs pour jusqu’à trois propriétés spécifiques de type 3. Parfois, Windows Explorer utilise cette API lors de l’enregistrement d’un fichier pour la première fois ou lors de la création d’un fichier après la sélection du menu Nouveau dans un menu contextuel.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shobjidl.h
DLL	Shell32.dll

Partager via