SHCreateShellItemArrayFromDataObject, fonction (shobjidl_core.h)

Crée un objet de tableau d’éléments Shell à partir d’un objet de données.

Syntaxe

SHSTDAPI SHCreateShellItemArrayFromDataObject(
  [in]  IDataObject *pdo,
  [in]  REFIID      riid,
  [out] void        **ppv
);

Paramètres

[in] pdo

Type : IDataObject*

Pointeur vers l’interface IDataObject .

[in] riid

Type : REFIID

Référence à l’ID d’interface souhaité.

[out] ppv

Type : void**

Lorsque cette méthode est retournée, contient le pointeur d’interface demandé dans riid. Il s’agit généralement d’IShellItemArray.

Valeur retournée

Type : HRESULT

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

Remarques

Cette fonction est utile pour les extensions Shell qui implémentent IShellExtInit et qui passent un objet de données à la méthode IShellExtInit ::Initialize  ; par exemple, les gestionnaires de menus contextuels.

Cette API vous permet de convertir l’objet de données en un élément Shell que le gestionnaire peut consommer. Il est recommandé que les gestionnaires utilisent un tableau d’éléments Shell plutôt que des formats de Presse-papiers tels que CF_HDROP et CFSTR_SHELLIDLIST (également appelé HIDA), car il conduit à du code plus simple et permet d’améliorer les performances.

Le tableau d’éléments d’interpréteur de commandes résultant contient une référence à l’objet de données source. Par conséquent, cet objet de données doit rester valide pendant toute la durée de vie du tableau d’éléments de l’interpréteur de commandes. Notamment, les objets de données passés aux méthodes IDropTarget ne sont plus valides une fois l’opération de suppression terminée.

Spécifications