Méthode IFileSaveDialog ::ApplyProperties (shobjidl_core.h)

Article
03/13/2024

Applique un ensemble de propriétés à un élément à l’aide du moteur de copie de l’interpréteur de commandes.

Syntaxe

HRESULT ApplyProperties(
  [in] IShellItem                 *psi,
  [in] IPropertyStore             *pStore,
  [in] HWND                       hwnd,
  [in] IFileOperationProgressSink *pSink
);

Paramètres

[in] psi

Type : IShellItem*

Pointeur vers l’élément IShellItem qui représente le fichier en cours d’enregistrement. Il s’agit généralement de l’élément récupéré par GetResult.

[in] pStore

Type : IPropertyStore*

Pointeur vers l’IPropertyStore qui représente les valeurs de propriété à appliquer au fichier. Il peut s’agir du magasin de propriétés retourné par IFileSaveDialog ::GetProperties.

[in] hwnd

Type : HWND

Handle de la fenêtre d’application.

[in] pSink

Type : IFileOperationProgressSink*

Pointeur vers un IFileOperationProgressSink facultatif que l’application appelante peut utiliser si elle souhaite être informée de la progression de l’empreinte de propriété. Cette valeur peut être NULL.

Valeur retournée

Type : HRESULT

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

Remarques

Cette méthode doit être utilisée lorsque l’application a activé la collection de propriétés (IFileSaveDialog ::SetCollectedProperties), mais ne conserve pas les propriétés elles-mêmes dans le fichier enregistré.

Note Le fichier représenté par l’élément spécifié dans psi doit exister dans le stockage physique avant d’effectuer l’appel à IFileSaveDialog ::ApplyProperties. Il doit donc avoir été enregistré précédemment à un moment donné.

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_core.h

Partager via