Fonction SHSetDefaultProperties (shobjidl.h)

Applique le jeu de propriétés par défaut sur un élément Shell.

Syntaxe

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

Paramètres

[in, optional] hwnd

Type : HWND

Handle de la fenêtre parente de l’élément, qui reçoit des notifications d’erreur. Cette valeur peut être NULL.

[in] psi

Type : IShellItem*

Pointeur vers l’objet IShellItem qui représente l’élément.

dwFileOpFlags

Type : DWORD

Indicateurs qui personnalisent l’opération. Pour connaître les valeurs d’indicateur , consultez IFileOperation::SetOperationFlags .

[in, optional] pfops

Type : IFileOperationProgressSink*

Pointeur vers un objet IFileOperationProgressSink utilisé pour suivre la progression de l’opération. Pour plus d’informations, consultez IFileOperation::Advise . Cette valeur peut être NULL.

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 pour définir une valeur par défaut provient de l’entrée de Registre SetDefaultsFor sous le ProgID pour l’association de fichiers de l’élément. 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 l’entrée SetDefaultsFor n’existe pas sur le ProgID, cette fonction utilise la valeur par défaut trouvée sur l’entrée SetDefaultsFor de HKEY_CLASSES_ROOT\*.

Configuration requise