Méthode IFileOperation::ApplyPropertiesToItems (shobjidl_core.h)
Déclare un ensemble d’éléments pour lesquels appliquer un ensemble commun de valeurs de propriété.
Syntaxe
HRESULT ApplyPropertiesToItems(
[in] IUnknown *punkItems
);
Paramètres
[in] punkItems
Type : IUnknown*
Pointeur vers l’IUnknown de l’objet IShellItemArray, IDataObject ou IEnumShellItems qui représente le groupe d’éléments. Vous pouvez également pointer vers un objet IPersistIDList pour représenter un élément unique, accomplissant de fait la même fonction que IFileOperation::ApplyPropertiesToItem.
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 n’applique pas les propriétés aux éléments, elle déclare simplement les éléments. Pour définir des valeurs de propriété sur un groupe d’éléments, vous devez effectuer au moins la séquence d’appels détaillée ici :
- Appelez IFileOperation::SetProperties pour déclarer les propriétés spécifiques à définir et leurs nouvelles valeurs.
- Appelez IFileOperation::ApplyPropertiesToItems pour déclarer les éléments dont les valeurs de propriété doivent être définies.
- Appelez IFileOperation::P erformOperations pour appliquer les propriétés aux éléments.
Configuration requise
| 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 (inclure Shobjidl.h) |