Fonction SHGetItemFromDataObject (shobjidl_core.h)

Article
03/04/2024

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)

Partager via