Fonction SHGetItemFromDataObject (shobjidl_core.h)

  • Article

Crée un objet IShellItem ou connexe basé sur un élément spécifié par un objet IDataObject.

Syntaxe

HRESULT SHGetItemFromDataObject(
  [in]  IDataObject            *pdtobj,
  [in]  DATAOBJ_GET_ITEM_FLAGS dwFlags,
  [in]  REFIID                 riid,
  [out] void                   **ppv
);

Paramètres

[in] pdtobj

Type : IDataObject*

Pointeur vers le instance IDataObject source.

[in] dwFlags

Type : DATAOBJ_GET_ITEM_FLAGS

Une ou plusieurs valeurs de l’énumération DATAOBJ_GET_ITEM_FLAGS pour spécifier des options concernant l’objet cible. Cette valeur peut être égale à 0.

[in] riid

Type : REFIID

Référence à l’IID de l’interface à récupérer via ppv, généralement IID_IShellItem.

[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’IShellItem.

Valeur retournée

Type : HRESULT

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

Remarques

Il est recommandé d’utiliser la macro IID_PPV_ARGS , définie dans Objbase.h, pour empaqueter les paramètres riid et ppv . Cette macro fournit l’IID correct en fonction de l’interface pointée par la valeur dans ppv, ce qui élimine la possibilité d’une erreur de codage.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible Windows
En-tête shobjidl_core.h (incluez Shobjidl.h)
DLL Shell32.dll (version 6.1 ou ultérieure)